estructura D3DHAL_CALLBACKS (d3dhal.h)
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 al D3dContextCreate devolución de llamada proporcionada por el controlador. Un controlador debe implementar la devolución de llamada a la que apunta este miembro.
ContextDestroy
Apunta al D3dContextDestroy proporcionado por el controlador devolución de llamada. 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, se trata de un puntero al D3dSceneCapture proporcionado por el controlador devolución de llamada. Para DirectX 7.0 y versiones posteriores, esta devolución de llamada se reemplazó por el control del estado de representación del D3DRENDERSTATE_SCENECAPTURE en la función D3dDrawPrimitives2.
lpReserved10
Debe ser cero.
lpReserved11
Debe ser cero.
RenderState
Apunta a la devolución de llamada 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 D3DHAL_RENDERPRIMITIVEDATA proporcionada por el controlador. Un controlador debe implementar la devolución de llamada a la que apunta este miembro.
dwReserved
Especifica campos reservados y debe establecerse en cero.
TextureCreate
Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero al D3dTextureCreate devolución de llamada o NULL.
TextureDestroy
Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero al controlador proporcionado D3dTextureDestroy devolución de llamada o NULL.
TextureSwap
Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero al D3dTextureSwap proporcionado por el controlador devolución de llamada o NULL.
TextureGetSurf
Debe establecerse en NULL en un controlador de Windows 2000 y versiones posteriores. Para DirectX 6.0, este era un puntero al D3dTextureGetSurf proporcionado por el controlador devolución de llamada 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 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.
Observaciones
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 lpD3DHALCallbacks miembro de la estructura DD_HALINFO.
La administración de texturas ahora se controla a través de códigos de operación administrados en la implementación del controlador de D3dDrawPrimitives2.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | d3dhal.h (incluya D3dhal.h) |