Microsoft Windows CE 3.0  

SurfaceHeap Constructor

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

When the SurfaceHeapclass is created, the constructor allocates a heap starting from an address that you specify. Initially, drivers should create a SurfaceHeapobject, giving it the total memory size available for graphics. Thereafter, that SurfaceHeapobject can be used to request smaller blocks of data.

When a SurfaceHeapobject is destroyed, memory that has been allocated for it, and all of its subheaps, is marked for reuse. If the top-level heap is destroyed, all memory is deallocated.

SurfaceHeap (
DWORD
size
,
ADDRESS
base
,
SurfaceHeap *
pNext
,
SurfaceHeap *
pPrev
);

Parameters

size
The size, in bytes, for the new heap. When you first create your heap, this value should be the total size of available memory.
base
The starting address for the heap.
pNext
The next heap in the list. When the heap is first created, this parameter should be set to NULL.
pPrev
The previous heap in the list. When the heap is first created, this parameter should be set to NULL.


 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.