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 指向驅動程序實作 的 D3dValidateTextureStageStageState 回 呼。

Clear2

必須設定為 NULL。 這是驅動程式提供的 D3dClear2 回呼指標，不再用於 DirectX 7.0 和更新版本。 相反地，驅動程式應該在其 D3dDrawPrimitives2 實作中回應D3DDP2OP_CLEAR命令數據流令牌。

lpvReserved

指定保留的欄位，而且必須在 Windows 2000 和更新版本中設定為 NULL 。

ValidateTextureStageState

指向驅動程式提供的 D3dValidateTextureStageState 回呼或 NULL。 支援多文集的驅動程序必須實作這個成員所指向的回呼。

DrawPrimitives2

指向驅動程式提供的 D3dDrawPrimitives2 回呼。 驅動程式必須實作這個成員所指向的回呼。

備註

驅動程式會配置此結構，並在所有成員中設定適當的值。 當使用 GUID_D3DCallbacks3 GUID 呼叫該函式時，驅動程式的 DdGetDriverInfo 函式會傳回這個結構的指標。

規格需求

需求	值
標頭	d3dhal.h (包含 D3dhal.h)

另請參閱

D3DDP2OP_CLEAR

D3DHAL_CALLBACKS

D3dDrawPrimitives2

D3dValidateTextureStageState

DdGetDriverInfo