DD_GETHEAPALIGNMENTDATA structure (dmemmgr.h)

The DD_GETHEAPALIGNMENTDATA structure contains data on required alignments from a particular heap.

Syntax

typedef struct _DD_GETHEAPALIGNMENTDATA {
  ULONG_PTR     dwInstance;
  DWORD         dwHeap;
  HRESULT       ddRVal;
  VOID          *GetHeapAlignment;
  HEAPALIGNMENT Alignment;
} DD_GETHEAPALIGNMENTDATA, *PDD_GETHEAPALIGNMENTDATA;

Members

dwInstance

Indicates the driver context as returned from the driver initialization routine and stored in the dhpDev member of the DD_DIRECTDRAW_GLOBAL structure.

dwHeap

Specifies the heap index passed by Microsoft DirectDraw. See the Remarks section for more information.

ddRVal

Specifies the location in which the driver writes the return value of the DdGetDriverInfo callback for a GUID_GetHeapAlignment query. A return code of DD_OK indicates success. For more information, see Return Values for DirectDraw.

GetHeapAlignment

Unused on Microsoft Windows 2000 and later versions of the operating system.

Alignment

Points to a HEAPALIGNMENT structure filled in by the driver.

Remarks

The dwHeap member is the ordinal number of the heap for which alignment data is being requested. In other words, it is the index into the array of VIDEOMEMORY structures pointed to by the pvmList parameter of the DrvGetDirectDrawInfo driver function.

Requirements

Requirement	Value
Header	dmemmgr.h (include Dmemmgr.h)

See also

DD_DIRECTDRAW_GLOBAL

DdGetDriverInfo

DrvGetDirectDrawInfo

HEAPALIGNMENT

VIDEOMEMORY