estructura D3DHAL_CALLBACKS (d3dhal.h)

Artículo
03/08/2023

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

Sintaxis

typedef struct _D3DHAL_CALLBACKS {
  DWORD                        dwSize;
  LPD3DHAL_CONTEXTCREATECB     ContextCreate;
  LPD3DHAL_CONTEXTDESTROYCB    ContextDestroy;
  LPD3DHAL_CONTEXTDESTROYALLCB ContextDestroyAll;
  LPD3DHAL_SCENECAPTURECB      SceneCapture;
  LPVOID                       lpReserved10;
  LPVOID                       lpReserved11;
  LPD3DHAL_RENDERSTATECB       RenderState;
  LPD3DHAL_RENDERPRIMITIVECB   RenderPrimitive;
  DWORD                        dwReserved;
  LPD3DHAL_TEXTURECREATECB     TextureCreate;
  LPD3DHAL_TEXTUREDESTROYCB    TextureDestroy;
  LPD3DHAL_TEXTURESWAPCB       TextureSwap;
  LPD3DHAL_TEXTUREGETSURFCB    TextureGetSurf;
  LPVOID                       lpReserved12;
  LPVOID                       lpReserved13;
  LPVOID                       lpReserved14;
  LPVOID                       lpReserved15;
  LPVOID                       lpReserved16;
  LPVOID                       lpReserved17;
  LPVOID                       lpReserved18;
  LPVOID                       lpReserved19;
  LPVOID                       lpReserved20;
  LPVOID                       lpReserved21;
  LPD3DHAL_GETSTATECB          GetState;
  DWORD                        dwReserved0;
  DWORD                        dwReserved1;
  DWORD                        dwReserved2;
  DWORD                        dwReserved3;
  DWORD                        dwReserved4;
  DWORD                        dwReserved5;
  DWORD                        dwReserved6;
  DWORD                        dwReserved7;
  DWORD                        dwReserved8;
  DWORD                        dwReserved9;
} D3DHAL_CALLBACKS, *LPD3DHAL_CALLBACKS;

Miembros

dwSize

Especifica el tamaño en bytes de esta estructura de D3DHAL_CALLBACKS.

ContextCreate

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

ContextDestroy

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

ContextDestroyAll

Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores.

SceneCapture

Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero a la devolución de llamada D3dSceneCapture proporcionada por el controlador. Para DirectX 7.0 y versiones posteriores, esta devolución de llamada se reemplazó por el control del estado de representación de D3DRENDERSTATE_SCENECAPTURE en la función D3dDrawPrimitives2 .

lpReserved10

Debe ser cero.

lpReserved11

Debe ser cero.

RenderState

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

RenderPrimitive

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

dwReserved

Especifica los campos reservados y se debe establecer en cero.

TextureCreate

Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero a la devolución de llamada D3dTextureCreate proporcionada por el controlador o NULL.

TextureDestroy

Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero a la devolución de llamada D3dTextureDestroy proporcionada por el controlador o NULL.

TextureSwap

Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero a la devolución de llamada D3dTextureSwap proporcionada por el controlador o NULL.

TextureGetSurf

Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero a la devolución de llamada D3dTextureGetSurf proporcionada por el controlador o NULL.

lpReserved12

Debe ser cero.

lpReserved13

Debe ser cero.

lpReserved14

Debe ser cero.

lpReserved15

Debe ser cero.

lpReserved16

Debe ser cero.

lpReserved17

Debe ser cero.

lpReserved18

Debe ser cero.

lpReserved19

Debe ser cero.

lpReserved20

Debe ser cero.

lpReserved21

Debe ser cero.

GetState

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

dwReserved0

Debe ser cero.

dwReserved1

Debe ser cero.

dwReserved2

Debe ser cero.

dwReserved3

Debe ser cero.

dwReserved4

Debe ser cero.

dwReserved5

Debe ser cero.

dwReserved6

Debe ser cero.

dwReserved7

Debe ser cero.

dwReserved8

Debe ser cero

dwReserved9

Debe ser cero.

Comentarios

El controlador asigna esta estructura y establece los valores adecuados en todos los miembros. La función DrvGetDirectDrawInfo del controlador devuelve un puntero a esta estructura en el miembro lpD3DHALCallbacks de la estructura DD_HALINFO .

La administración de texturas ahora se controla a pesar de los códigos de operación que se administran en la implementación del controlador de D3dDrawPrimitives2.