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