estrutura D3DHAL_CALLBACKS3 (d3dhal.h)

Artigo
08/07/2023

D3DHAL_CALLBACKS3 é uma das várias estruturas de retorno de chamada que descrevem o suporte do Direct3D fornecido pelo driver.

Sintaxe

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

Membros

dwSize

Especifica o tamanho em bytes dessa estrutura.

dwFlags

Indica os retornos de chamada associados a essa estrutura que o driver implementou. Para cada bit que o driver define em dwFlags, o driver deve inicializar o membro do ponteiro de função correspondente dessa estrutura. Esse membro pode ser o OR bit a bit de um ou mais dos seguintes sinalizadores:

Sinalizador	Significado
D3DHAL3_CB32_CLEAR2	Não usado no DirectX 7.0 e em versões posteriores.
D3DHAL3_CB32_DRAWPRIMITIVES2	O DrawPrimitives2member aponta para um retorno de chamada D3dDrawPrimitives2 implementado pelo driver.
D3DHAL3_CB32_RESERVED	Não usado no DirectX 7.0 e em versões posteriores.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	O ValidateTextureStageStatemember aponta para um retorno de chamada D3dValidateTextureStageState implementado pelo driver.

Clear2

Deve ser definido como NULL. Esse foi um ponteiro para o retorno de chamada D3dClear2 fornecido pelo driver que não é mais usado para o DirectX 7.0 e posterior. Em vez disso, o driver deve responder ao token de fluxo de comando D3DDP2OP_CLEAR em sua implementação de D3dDrawPrimitives2.

lpvReserved

Especifica um campo reservado e deve ser definido como NULL em um driver do Windows 2000 e posterior.

ValidateTextureStageState

Aponta para o retorno de chamada D3dValidateTextureStageState fornecido pelo driver ou NULL. Os drivers que dão suporte à multitextação devem implementar o retorno de chamada para o qual esse membro aponta.

DrawPrimitives2

Aponta para o retorno de chamada D3dDrawPrimitives2 fornecido pelo driver. Um driver deve implementar o retorno de chamada para o qual esse membro aponta.

Comentários

O driver aloca essa estrutura e define os valores apropriados em todos os membros. A função DdGetDriverInfo do driver retorna um ponteiro para essa estrutura quando essa função é chamada com o GUID GUID_D3DCallbacks3.