SSAllocMem
From EDM2
SSAllocMem allocates a shared memory object that is managed by the selector server component of the graphics engine.
Contents
Syntax
SSAllocMem(pBaseAddress, ObjectSize, Flags)
Parameters
- pBaseAddress (PVOID) - input
- Pointer to a variable, which will receive the base address of the allocated memory.
- ObjectSize (ULONG) - input
- Value that specifies the size in bytes of the shared memory to allocate. The size is rounded up to the next page boundary.
- Flags (ULONG) - input
- Reserved.
- Reserved. Must be 0.
Returns
- rc (ULONG) - returns
- Return codes.
- SSAllocMem returns a ULONG value:
- NO_ERROR
- ERROR_INVALID_PARAMETER
- ERROR_NOT_ENOUGH_MEMORY.
- Note
- :Other return codes listed under DosAllocSharedMem might also apply.
Remarks
Presentation drivers should use SSAllocMem to allocate memory for objects, such as bit maps and regions, to ensure that the returned memory object is a global memory object for which the system can set a new owner, or which can be marked as having no owner.
In some presentation devices, the handling routine for FillLogicalDeviceBlock (OS2_PM_DRV_ENABLE, sub-function 2) allocates global heap space for use by the device contexts. The memory for this heap space is obtained by calling the SSAllocMem function.