Share via


SurfaceHeap Constructor (Compact 2013)

3/26/2014

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.

Syntax

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

See Also

Reference

SurfaceHeap Class
SurfaceHeap Class Definition