D3DHAL_CALLBACKS3 structure (d3dhal.h)
D3DHAL_CALLBACKS3 is one of several callback structures that describe the Direct3D support provided by the driver.
Syntax
typedef struct _D3DHAL_CALLBACKS3 {
DWORD dwSize;
DWORD dwFlags;
LPD3DHAL_CLEAR2CB Clear2;
LPVOID lpvReserved;
LPD3DHAL_VALIDATETEXTURESTAGESTATECB ValidateTextureStageState;
LPD3DHAL_DRAWPRIMITIVES2CB DrawPrimitives2;
} D3DHAL_CALLBACKS3, *LPD3DHAL_CALLBACKS3;
Members
dwSize
Specifies the size in bytes of this structure.
dwFlags
Indicates the callbacks associated with this structure that the driver has implemented. For every bit the driver sets in dwFlags, the driver must initialize the corresponding function pointer member of this structure. This member can be the bitwise-OR of one or more of the following flags:
| Flag | Meaning |
|---|---|
| D3DHAL3_CB32_CLEAR2 | Not used in DirectX 7.0 and later versions. |
| D3DHAL3_CB32_DRAWPRIMITIVES2 | The DrawPrimitives2member points to a driver-implemented D3dDrawPrimitives2 callback. |
| D3DHAL3_CB32_RESERVED | Not used in DirectX 7.0 and later versions. |
| D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE | The ValidateTextureStageStatemember points to a driver-implemented D3dValidateTextureStageState callback. |
Clear2
Must be set to NULL. This was a pointer to the driver-supplied D3dClear2 callback that is no longer used for DirectX 7.0 and beyond. Instead the driver should respond to the D3DDP2OP_CLEAR command stream token in its implementation of D3dDrawPrimitives2.
lpvReserved
Specifies a reserved field and must be set to NULL in a Windows 2000 and later driver.
ValidateTextureStageState
Points to the driver-supplied D3dValidateTextureStageState callback, or NULL. Drivers that support multitexturing must implement the callback that this member points to.
DrawPrimitives2
Points to the driver-supplied D3dDrawPrimitives2 callback. A driver must implement the callback that this member points to.
Remarks
The driver allocates this structure and sets appropriate values in all members. The driver's DdGetDriverInfo function returns a pointer to this structure when that function is called with the GUID_D3DCallbacks3 GUID.
Requirements
| Requirement | Value |
|---|---|
| Header | d3dhal.h (include D3dhal.h) |
See also
D3DDP2OP_CLEAR