Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| en:docs:fapi:dosallochuge [2021/09/16 13:07] – prokushev | en:docs:fapi:dosallochuge [2021/10/16 14:05] (current) – prokushev | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | {{logos:os2.gif? | + | {{page>en:templates:fapiint}} |
| ====== DosAllocHuge ====== | ====== DosAllocHuge ====== | ||
| Line 16: | Line 17: | ||
| * Size ([[USHORT]]) - input : Number of bytes to be allocated in the last (non-65536-byte) segment. A value of zero indicates none. | * Size ([[USHORT]]) - input : Number of bytes to be allocated in the last (non-65536-byte) segment. A value of zero indicates none. | ||
| * Selector ([[PSEL]]) - output : Address where the selector of the first segment allocated is returned. | * Selector ([[PSEL]]) - output : Address where the selector of the first segment allocated is returned. | ||
| - | * MaxNumSeg ([[USHORT]]) - input : Maximum number of 65536-byte segments this object occupies as a result of any subsequent [[DosReallocHuge]]. If MaxNumSeg is 0, OS/2 assumes this segment will never be increased by DosReallocHuge beyond its original size, though it may be decreased. This value is ignored in the DOS mode. | + | * MaxNumSeg ([[USHORT]]) - input : Maximum number of 65536-byte segments this object occupies as a result of any subsequent [[DosReallocHuge]]. If MaxNumSeg is 0, OS/2 assumes this segment will never be increased by [[DosReallocHuge]] beyond its original size, though it may be decreased. This value is ignored in the DOS mode. |
| * AllocFlags ([[USHORT]]) - input : Bit indicators describing the characteristics of the segment allocated. The bits that can be set and their meanings are: | * AllocFlags ([[USHORT]]) - input : Bit indicators describing the characteristics of the segment allocated. The bits that can be set and their meanings are: | ||
| - | ^ Bit ^ Description ^ | + | ^ Bit ^ Description ^ |
| | 15-4 | Reserved and must be set to zero. | | | 15-4 | Reserved and must be set to zero. | | ||
| | 3 | If segment is shared, it can be decreased in size by [[DosReallocHuge]]. | | | 3 | If segment is shared, it can be decreased in size by [[DosReallocHuge]]. | | ||
| Line 35: | Line 36: | ||
| ===== Return Code ===== | ===== Return Code ===== | ||
| - | | + | rc ([[USHORT]]) - return |
| Return code descriptions are: | Return code descriptions are: | ||
| Line 62: | Line 63: | ||
| **Note:** This request may be issued from privilege level 2. However, the segment is allocated as a privilege level 3 segment. | **Note:** This request may be issued from privilege level 2. However, the segment is allocated as a privilege level 3 segment. | ||
| - | ===Family API Considerations=== | + | ==== Family API Considerations ==== |
| Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following considerations apply to DosAllocHuge when coding for the DOS mode: | Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following considerations apply to DosAllocHuge when coding for the DOS mode: | ||
| Line 69: | Line 71: | ||
| * Selector is the actual segment address allocated. | * Selector is the actual segment address allocated. | ||
| - | ==Example Code== | + | ===== Example Code ===== |
| - | === C Binding=== | + | |
| + | ==== C Binding | ||
| <code c> | <code c> | ||
| Line 87: | Line 90: | ||
| </ | </ | ||
| - | === Example === | + | ==== Example |
| This example requests a block of memory with 4 segments, the last segment having 1,040 bytes. The block of memory will never be larger than 8 segments. The memory can be shared with DosGiveSeg API calls. The system can discard the memory if it needs too. | This example requests a block of memory with 4 segments, the last segment having 1,040 bytes. The block of memory will never be larger than 8 segments. The memory can be shared with DosGiveSeg API calls. The system can discard the memory if it needs too. | ||
| Line 109: | Line 112: | ||
| </ | </ | ||
| - | === ASM Binding === | + | ==== MASM Binding ==== |
| <code asm> | <code asm> | ||
| EXTRN DosAllocHuge: | EXTRN DosAllocHuge: | ||
| Line 123: | Line 127: | ||
| Returns WORD | Returns WORD | ||
| </ | </ | ||
| - | ====== Note ====== | + | ===== Note ===== |
| Text based on [[http:// | Text based on [[http:// | ||