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 回调。 驱动程序必须实现此成员指向的回调。

注解

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

要求

要求 值
Header d3dhal.h (包括 D3dhal.h)

另请参阅

D3DDP2OP_CLEAR

D3DHAL_CALLBACKS

D3dDrawPrimitives2

D3dValidateTextureStageState

DdGetDriverInfo