DDHAL_GETHEAPALIGNMENTDATA (Windows CE 5.0)
This structure contains data on required alignments from a particular heap.
typedef struct _DDHAL_GETHEAPALIGNMENTDATA {DWORDdwInstance;DWORDdwHeap;HRESULTddRVal;LPDDHAL_GETHEAPALIGNMENTGetHeapAlignment;HEAPALIGNMENTAlignment;} 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 HEAPALIGNMENT structure filled in by the driver.
Remarks
This structure is different from other HAL callbacks in that no DDRAWI_DIRECTDRAW_GBL is passed in to the driver. This is because GetHeapAlignment is 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 dwReserved3 field of the DDRAWI_DIRECTDRAW_GBL structure.
The dwHeap member is the ordinal number of the heap for which alignment data is being requested. That is, it is the index into the array of VIDMEM structures pointed to by the pvmList member of the vmiData member of the DDHALINFO structure.
Requirements
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddrawi.h.
See Also
DDRAWI_DIRECTDRAW_GBL | GetHeapAlignment | VIDMEM | DDHALINFO | Miscellaneous Structures
Send Feedback on this topic to the authors