MFSH_SEGALLOC

Allocate memory.

Syntax

int far pascal MFSH_SEGALLOC(usFlag, cbSeg, pusSel)

Parameters

usFlag

is set to 1 if the memory must be below the 1-meg boundary or 0 if its location does not matter.

cbSeg

contains the length of the segment.

pusSel

is a pointer to a word in which the helper returns the selector of the segment.

Returns

If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned:

ERROR_NOT_ENOUGH_MEMORY

too much memory is allocated.

ERROR_PROTECTION_VIOLATION

the supplied address is invalid.

ERROR_INVALID_PARAMETER

either the supplied flag or length is invalid.

Sample

unsigned short usFlag;
unsigned long cbSeg;
unsigned short far * pusSel;

int far pascal MFSH_SEGALLOC(usFlag, cbSeg, pusSel)

Remarks

This function allocates memory with the following attributes:

• Allocated from the GDT
• Non-swappable

Memory not allocated specifically below the 1-Meg boundary may be given to the FSD by passing the selectors through pMiniFSD (see MFS_INIT and FS_INIT).