estructura D3DHAL_CALLBACKS3 (d3dhal.h)

Artículo
03/08/2023

D3DHAL_CALLBACKS3 es una de varias estructuras de devolución de llamada que describen la compatibilidad de Direct3D proporcionada por el controlador.

Sintaxis

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

Miembros

dwSize

Especifica el tamaño en bytes de esta estructura.

dwFlags

Indica las devoluciones de llamada asociadas a esta estructura que el controlador ha implementado. Para cada bit, el controlador establece en dwFlags, el controlador debe inicializar el miembro de puntero de función correspondiente de esta estructura. Este miembro puede ser el or bit a bit de uno o varios de los siguientes marcadores:

Marcar	Significado
D3DHAL3_CB32_CLEAR2	No se usa en DirectX 7.0 y versiones posteriores.
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member apunta a una devolución de llamada D3dDrawPrimitives2 implementada por el controlador.
D3DHAL3_CB32_RESERVED	No se usa en DirectX 7.0 y versiones posteriores.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	ValidateTextureStageStatemember apunta a una devolución de llamada D3dValidateTextureStageState implementada por el controlador.

Clear2

Debe establecerse en NULL. Se trata de un puntero a la devolución de llamada D3dClear2 proporcionada por el controlador que ya no se usa para DirectX 7.0 y versiones posteriores. En su lugar, el controlador debe responder al token de secuencia de comandos de D3DDP2OP_CLEAR en su implementación de D3dDrawPrimitives2.

lpvReserved

Especifica un campo reservado y debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores.

ValidateTextureStageState

Apunta a la devolución de llamada D3dValidateTextureStageState proporcionada por el controlador o NULL. Los controladores que admiten multitexturing deben implementar la devolución de llamada a la que apunta este miembro.

DrawPrimitives2

Apunta a la devolución de llamada D3dDrawPrimitives2 proporcionada por el controlador. Un controlador debe implementar la devolución de llamada a la que apunta este miembro.

Comentarios

El controlador asigna esta estructura y establece los valores adecuados en todos los miembros. La función DdGetDriverInfo del controlador devuelve un puntero a esta estructura cuando se llama a esa función con el GUID de GUID_D3DCallbacks3.