D3DHAL_CALLBACKS3结构（d3dhal.h）

D3DHAL_CALLBACKS3是描述驱动程序提供的 Direct3D 支持的多个回调结构之一。

语法

typedef struct _D3DHAL_CALLBACKS3 {
  DWORD                                dwSize;
  DWORD                                dwFlags;
  LPD3DHAL_CLEAR2CB                    Clear2;
  LPVOID                               lpvReserved;
  LPD3DHAL_VALIDATETEXTURESTAGESTATECB ValidateTextureStageState;
  LPD3DHAL_DRAWPRIMITIVES2CB           DrawPrimitives2;
} D3DHAL_CALLBACKS3, *LPD3DHAL_CALLBACKS3;

成员

dwSize

指定此结构的大小（以字节为单位）。

dwFlags

指示驱动程序已实现的与此结构关联的回调。 对于 dwFlags中的每个位，驱动程序必须初始化此结构的相应函数指针成员。 此成员可以是以下一个或多个标志的按位 OR：

标志	含义
D3DHAL3_CB32_CLEAR2	在 DirectX 7.0 及更高版本中未使用。
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member 指向驱动程序实现的 D3dDrawPrimitives2 回调。
D3DHAL3_CB32_RESERVED	在 DirectX 7.0 及更高版本中未使用。
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	ValidateTextureStageStatemember 指向驱动程序实现 D3dValidateTextureStageState 回调。

Clear2

必须设置为 NULL。 这是指向驱动程序提供的 D3dClear2 回调的指针，该回调不再用于 DirectX 7.0 及更高版本。 相反，驱动程序应在 D3dDrawPrimitives2的实现中响应D3DDP2OP_CLEAR命令流令牌。

lpvReserved

指定保留字段，并且必须设置为在 Windows 2000 及更高版本中 NULL。

ValidateTextureStageState

指向驱动程序提供的 D3dValidateTextureStageState 回调，或 NULL。 支持多文本的驱动程序必须实现此成员指向的回调。

DrawPrimitives2

指向驱动程序提供的 D3dDrawPrimitives2 回调。 驱动程序必须实现此成员指向的回调。

言论

驱动程序分配此结构并在所有成员中设置适当的值。 驱动程序的 DdGetDriverInfo 函数在使用 GUID_D3DCallbacks3 GUID 调用该函数时返回指向此结构的指针。

要求

要求	价值
标头	d3dhal.h （包括 D3dhal.h）

另请参阅

D3DDP2OP_CLEAR

D3DHAL_CALLBACKS

D3dDrawPrimitives2

D3dValidateTextureStageState

DdGetDriverInfo