Microsoft Windows CE 3.0  

DDHAL_GETHEAPALIGNMENTDATA

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.

The DDHAL_GETHEAPALIGNMENTDATAstructure contains data on required alignments from a particular heap.

typedef struct _DDHAL_GETHEAPALIGNMENTDATA { DWORD
dwInstance
;
DWORD
dwHeap
;
HRESULT
ddRVal
;
LPDDHAL_GETHEAPALIGNMENT
GetHeapAlignment
;
HEAPALIGNMENT
Alignment
;
} DDHAL_GETHEAPALIGNMENTDATA;

Members

dwInstance
Indicates the driver context as returned from the 32-bit driver initialization routine.
dwHeap
The heap index passed by DirectDraw.
ddRVal
Passes the DirectDraw return values.
GetHeapAlignment
This member is used by DirectDraw and should not be filled in by the driver.
Alignment
Pointer to a HEAPALIGNMENTstructure filled in by the driver.

Remarks

This structure is different from other HAL callbacks in that no DDRAWI_DIRECTDRAW_GBLis passed in to the driver. This is because this GetHeapAlignmentis called before that structure is fully initialized. The driver can deduce its context from the dwInstance member. This value will be the same as that returned by the 32-bit driver initialization entry point (which is also stored in the dwReserved3field of the DDRAWI_DIRECTDRAW_GBLstructure).

The dwHeapmember 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 VIDMEMstructures pointed to by the pvmListmember of the vmiDatamember of the DDHALINFOstructure.



 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.