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

D3DHAL_CALLBACKS

D3dDrawPrimitives2

D3dValidateTextureStageState

DdGetDriverInfo