D3DHAL_CALLBACKS3 structure (d3dhal.h)

Article
02/26/2024

D3DHAL_CALLBACKS3 est l’une des structures de rappel qui décrivent la prise en charge de Direct3D fournie par le pilote.

Syntaxe

typedef struct _D3DHAL_CALLBACKS3 {
  DWORD                                dwSize;
  DWORD                                dwFlags;
  LPD3DHAL_CLEAR2CB                    Clear2;
  LPVOID                               lpvReserved;
  LPD3DHAL_VALIDATETEXTURESTAGESTATECB ValidateTextureStageState;
  LPD3DHAL_DRAWPRIMITIVES2CB           DrawPrimitives2;
} D3DHAL_CALLBACKS3, *LPD3DHAL_CALLBACKS3;

Membres

dwSize

Spécifie la taille en octets de cette structure.

dwFlags

Indique les rappels associés à cette structure que le pilote a implémentés. Pour chaque bit que le pilote définit dans dwFlags, le pilote doit initialiser le membre de pointeur de fonction correspondant de cette structure. Ce membre peut être le ou au niveau du bit d’un ou plusieurs des indicateurs suivants :

Indicateur	Signification
D3DHAL3_CB32_CLEAR2	Non utilisé dans DirectX 7.0 et versions ultérieures.
D3DHAL3_CB32_DRAWPRIMITIVES2	Le drawPrimitives2member pointe vers un rappel D3dDrawPrimitives2 implémenté par le pilote.
D3DHAL3_CB32_RESERVED	Non utilisé dans DirectX 7.0 et versions ultérieures.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	Le validateTextureStageStatemember pointe vers un rappel D3dValidateTextureStageState implémenté par le pilote.

Clear2

Doit être défini sur NULL. Il s’agissait d’un pointeur vers le rappel D3dClear2 fourni par le pilote qui n’est plus utilisé pour DirectX 7.0 et versions ultérieures. Au lieu de cela, le pilote doit répondre au jeton de flux de commande D3DDP2OP_CLEAR dans son implémentation de D3dDrawPrimitives2.

lpvReserved

Spécifie un champ réservé et doit être défini sur NULL dans un pilote Windows 2000 et ultérieur.

ValidateTextureStageState

Pointe vers le rappel D3dValidateTextureStageState fourni par le pilote, ou NULL. Les pilotes qui prennent en charge le multitexturage doivent implémenter le rappel vers lequel pointe ce membre.

DrawPrimitives2

Pointe vers le rappel D3dDrawPrimitives2 fourni par le pilote. Un pilote doit implémenter le rappel vers lequel pointe ce membre.

Remarques

Le pilote alloue cette structure et définit les valeurs appropriées dans tous les membres. La fonction DdGetDriverInfo du pilote retourne un pointeur vers cette structure lorsque cette fonction est appelée avec le GUID GUID_D3DCallbacks3.