dos12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
DosGetHugeShift (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSMEMMGR
 
USHORT DosGetHugeShift(pusShiftCount)
PUSHORT pusShiftCount;    /* pointer to variable receiving shift count */
 
The DosGetHugeShift function retrieves the shift count used to compute the
segment-selector offset for huge memory segments. (Huge memory segments are
allocated by using the DosAllocHuge function.) The shift count represents a
multiple of two, so the segment-selector offset is equal to the value 1
shifted left by the shift count. For example, the segment-selector offset is
eight if the shift count is three.
 
The DosGetHugeShift function is a family API function.
 
Parameter      Description
────────────────────────────────────────────────────────────────────────────
 
pusShiftCount  Points to the variable that receives the shift count.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value.
 
See Also
 
DosAllocHuge