D3DHAL_CALLBACKS3 struttura (d3dhal.h)

Articolo
02/26/2024

D3DHAL_CALLBACKS3 è una delle diverse strutture di callback che descrivono il supporto Direct3D fornito dal driver.

Sintassi

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

Specifica le dimensioni in byte di questa struttura.

dwFlags

Indica i callback associati a questa struttura implementata dal driver. Per ogni bit i set di driver in dwFlags, il driver deve inizializzare il membro del puntatore della funzione corrispondente di questa struttura. Questo membro può essere bit per bit-OR di uno o più flag seguenti:

Bandiera	Significato
D3DHAL3_CB32_CLEAR2	Non usato nelle versioni DirectX 7.0 e versioni successive.
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member punta a un callback D3dDrawPrimitives2 implementato dal driver.
D3DHAL3_CB32_RESERVED	Non usato nelle versioni DirectX 7.0 e versioni successive.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	ValidateTextureStageStatemember punta a un callback D3dValidateTextureStageState implementato dal driver.

Clear2

Deve essere impostato su NULL. Questo è stato un puntatore al callback D3dClear2 fornito dal driver che non è più usato per DirectX 7.0 e oltre. Il driver deve invece rispondere al token di flusso di comando D3DDP2OP_CLEAR nell'implementazione di D3dDrawPrimitives2.

lpvReserved

Specifica un campo riservato e deve essere impostato su NULL in un driver Windows 2000 e versioni successive.

ValidateTextureStageState

Punta al callback D3dValidateTextureStageState fornito dal driver o NULL. I driver che supportano il multitexturing devono implementare il callback a cui punta questo membro.

DrawPrimitives2

Punta al callback D3dDrawPrimitives2 fornito dal driver. Un driver deve implementare il callback a cui punta questo membro.

Commenti

Il driver alloca questa struttura e imposta i valori appropriati in tutti i membri. La funzione DdGetDriverInfo del driver restituisce un puntatore a questa struttura quando questa funzione viene chiamata con il GUID GUID_D3DCallbacks3.