Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
en:docs:fapi:dosreallochuge [2018/08/30 17:20] – created prokushev | en:docs:fapi:dosreallochuge [2021/09/18 14:45] (current) – prokushev | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{page> | ||
+ | |||
+ | ====== DosReallocHuge ====== | ||
+ | |||
This call changes the size of memory originally allocated by DosAllocHuge. | This call changes the size of memory originally allocated by DosAllocHuge. | ||
- | ==Syntax== | + | ===== Syntax ===== |
- | | + | <code c> |
+ | DosReallocHuge (NumSeg, Size, Selector) | ||
+ | </ | ||
- | ==Parameters== | + | ===== Parameters ===== |
- | ;NumSeg (USHORT) - input : Number of 65536 byte segments requested. | + | |
- | ;Size (USHORT) - input : Number of bytes requested in the last non-65536 byte segment. A value of 0 indicates none. | + | |
- | ;Selector (SEL) - input : Selector returned on a previous DosAllocHuge. | + | |
+ | | ||
+ | |||
+ | ===== Return Code ===== | ||
+ | |||
+ | rc ([[USHOR]]T) - return | ||
- | ==Return Code== | ||
- | rc (USHORT) - return | ||
Return code descriptions are: | Return code descriptions are: | ||
- | * 0 | ||
- | * 8 | ||
- | * 87 ERROR_INVALID_PARAMETER | ||
- | ==Remarks== | + | * 0 |
+ | * 8 | ||
+ | * 87 ERROR_INVALID_PARAMETER | ||
+ | |||
+ | ===== Remarks ===== | ||
DosReallocHuge is called to change the size of unshared or shared huge memory allocated by DosAllocHuge. The selector used for this call must be the one returned by the DosAllocHuge request. | DosReallocHuge is called to change the size of unshared or shared huge memory allocated by DosAllocHuge. The selector used for this call must be the one returned by the DosAllocHuge request. | ||
Line 25: | Line 36: | ||
''' | ''' | ||
- | ===Family API Considerations=== | + | ==== Family API Considerations ==== |
Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following restriction applies to DosReallocHuge when coding for the DOS mode: | Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following restriction applies to DosReallocHuge when coding for the DOS mode: | ||
The requested Size value is rounded up to the next paragraph (16-byte). | The requested Size value is rounded up to the next paragraph (16-byte). | ||
- | ==Example Code== | + | ===== Bindings ===== |
- | === C Binding=== | + | |
- | <PRE> | + | ==== C Binding ==== |
+ | |||
+ | <code c> | ||
#define INCL_DOSMEMMGR | #define INCL_DOSMEMMGR | ||
Line 43: | Line 57: | ||
USHORT | USHORT | ||
- | </PRE> | + | </code> |
+ | |||
+ | ==== MASM Binding ==== | ||
- | ===MASM Binding=== | + | <code asm> |
- | <PRE> | + | |
EXTRN DosReallocHuge: | EXTRN DosReallocHuge: | ||
INCL_DOSMEMMGR | INCL_DOSMEMMGR | ||
Line 56: | Line 71: | ||
Returns WORD | Returns WORD | ||
- | </PRE> | + | </code> |
- | ====== Note ====== | + | ===== Note ===== |
Text based on [[http:// | Text based on [[http:// |