 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 DDHALINFOstructure collects all the information needed to create an instance of your driver. It is filled out in buildDDHALInfo16and buildDDHALInfo32and contains all the unchanging function names and capabilities of this hardware and driver.
typedef struct _DDHALINFO { DWORD
dwSize
;
LPDDHAL_DDCALLBACKS
lpDDCallbacks
;
LPDDHAL_DDSURFACECALLBACKS
lpDDSurfaceCallbacks
;
LPDDHAL_DDPALETTECALLBACKS
lpDDPaletteCallbacks
;
VIDMEMINFO
vmiData
;
DDCORECAPS
ddCaps
;
DWORD
dwMonitorFrequency
;
LPDDHAL_GETDRIVERINFO
GetDriverInfo
;
DWORD
dwModeIndex
;
LPDWORD
lpdwFourCC
;
DWORD
dwNumModes
;
LPDDHALMODEINFO
lpModeInfo
;
DWORD
dwFlags
;
LPVOID
lpPDevice
;
DWORD
hInstance
;
ULONG_PTR
lpD3DGlobalDriverData
;
ULONG_PTR
lpD3DHALCallbacks
;
LPDDHAL_DDEXEBUFCALLBACKS
lpDDExeBufCallbacks
;
} DDHALINFO;
typedef DDHALINFO FAR *LPDDHALINFO;
Members
- dwSize
- Size of the structure. This member must be initialized before the structure is used.
- lpDDCallbacks
- Pointer to the DirectDraw object callbacks ( DDHAL_DDCALLBACKS).
- lpDDSurfaceCallbacks
- Pointer to the DirectDrawSurface object callbacks ( DDHAL_DDSURFACECALLBACKS).
- lpDDPaletteCallbacks
- Pointer to the DirectDrawPalette object callbacks ( DDHAL_DDPALETTECALLBACKS).
- vmiData
- Pointer to a VIDMEMINFOstructure where you put the display memory information.
- ddCaps
- The DDCORECAPSstructure that specifies the capabilities the hardware can set.
- dwMonitorFrequency
- Indicates the monitor frequency in the current mode.
- GetDriverInfo
- Pointer to a GetDriverInfocallback function that will be used to get further DirectDraw HAL information.
- dwModeIndex
- Index into a mode array that indicates the current mode.
- lpdwFourCC
- Indicates the FourCC codes supported in this mode only, and are listed in the order of preference of use (speed and quality).
- dwNumModes
- Indicates the number of modes supported.
- lpModeInfo
- Pointer to a DDHALMODEINFOstructure that contains the mode information.
- dwFlags
- Display driver create flags.
Flag Usage DDHALINFO_GETDRIVERINFOSET Indicates that GetDriverInfois set. DDHALINFO_ISPRIMARYDISPLAY Indicates the driver is the primary display driver. DDHALINFO_MODEXILLEGAL Indicates this hardware does not support ModeX modes. - lpPDevice
- Pointer to the physical device pointer (pdevice) in the display minidriver.
- hInstance
- Instance handle to the base display driver.
- lpD3DGlobalDriverData
- Not used on Windows CE.
- lpD3DHALCallbacks
- Not used on Windows CE.
- lpDDExeBufCallbacks
- This member is for future use.
Last updated on Tuesday, July 13, 2004