SSAllocMem

SSAllocMem allocates a shared memory object that is managed by the selector server component of the graphics engine.

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.

Sample

 * 1) include 

PVOID   pBaseAddress; ULONG   ObjectSize; ULONG   Flags;         /*  Reserved. */ ULONG   rc;            /*  Return codes. */

rc = SSAllocMem(pBaseAddress, ObjectSize,      Flags);

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.