struttura D3DHAL_CALLBACKS3 (d3dhal.h)

Articolo
02/06/2025

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;

Membri

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 di funzione corrispondente di questa struttura. Questo membro può essere l'OR bit per bit di uno o più dei flag seguenti:

Flag	significato
D3DHAL3_CB32_CLEAR2	Non usato in DirectX 7.0 e versioni successive.
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member punta a un callback implementato dal driver D3dDrawPrimitives2.
D3DHAL3_CB32_RESERVED	Non usato in DirectX 7.0 e versioni successive.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	ValidateTextureStageStatemember punta a un callback implementato dal driver D3dValidateTextureStageState.

Clear2

Deve essere impostato su NULL. Si tratta di un puntatore al callback fornito dal driver D3dClear2 non più usato per DirectX 7.0 e versioni successive. Il driver deve invece rispondere al token del flusso di comandi 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 oppure NULL. I driver che supportano il multitexturing devono implementare il callback a cui punta questo membro.

DrawPrimitives2

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

Osservazioni

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 tale funzione viene chiamata con il GUID GUID_D3DCallbacks3.