Partager via


SurfaceHeap Constructor (Windows Embedded CE 6.0)

1/6/2010

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

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.

Return Values

None.

Remarks

When a SurfaceHeap object 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.

Requirements

Header ddgpe.h
Library Ddgpe.lib
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Concepts

SurfaceHeap Class
SurfaceHeap Class Definition