SSAllocMem

From EDM2
Jump to: navigation, search

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.

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.