View source for MFSH SEGALLOC

{{DISPLAYTITLE: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).