Edit

D3DHAL_CALLBACKS structure (d3dhal.h)

  • Article

D3DHAL_CALLBACKS is one of several callback structures that describe the Direct3D support provided by the driver.

Syntax

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;

Members

dwSize

Specifies the size in bytes of this D3DHAL_CALLBACKS structure.

ContextCreate

Points to the driver-supplied D3dContextCreate callback. A driver must implement the callback that this member points to.

ContextDestroy

Points to the driver-supplied D3dContextDestroy callback. A driver must implement the callback that this member points to.

ContextDestroyAll

Must be set to NULL in a Windows 2000 and later driver.

SceneCapture

Must be set to NULL in a Windows 2000 and later driver. For DirectX 6.0, this was a pointer to the driver-supplied D3dSceneCapture callback. For DirectX 7.0 and later, this callback was replaced by the handling of the D3DRENDERSTATE_SCENECAPTURE render state in the D3dDrawPrimitives2 function.

lpReserved10

Must be zero.

lpReserved11

Must be zero.

RenderState

Points to the driver-supplied D3DHAL_RENDERSTATEDATA callback. A driver must implement the callback that this member points to.

RenderPrimitive

Points to the driver-supplied D3DHAL_RENDERPRIMITIVEDATA callback. A driver must implement the callback that this member points to.

dwReserved

Specifies reserved fields and must be set to zero.

TextureCreate

Must be set to NULL in a Windows 2000 and later driver. For DirectX 6.0, this was a pointer to the driver-supplied D3dTextureCreate callback, or NULL.

TextureDestroy

Must be set to NULL in a Windows 2000 and later driver. For DirectX 6.0, this was a pointer to the driver-supplied D3dTextureDestroy callback, or NULL.

TextureSwap

Must be set to NULL in a Windows 2000 and later driver. For DirectX 6.0, this was a pointer to the driver-supplied D3dTextureSwap callback, or NULL.

TextureGetSurf

Must be set to NULL in a Windows 2000 and later driver. For DirectX 6.0, this was a pointer to the driver-supplied D3dTextureGetSurf callback, or NULL.

lpReserved12

Must be zero.

lpReserved13

Must be zero.

lpReserved14

Must be zero.

lpReserved15

Must be zero.

lpReserved16

Must be zero.

lpReserved17

Must be zero.

lpReserved18

Must be zero.

lpReserved19

Must be zero.

lpReserved20

Must be zero.

lpReserved21

Must be zero.

GetState

Points to the driver-supplied D3DHAL_GETSTATEDATA callback. A driver must implement the callback that this member points to.

dwReserved0

Must be zero.

dwReserved1

Must be zero.

dwReserved2

Must be zero.

dwReserved3

Must be zero.

dwReserved4

Must be zero.

dwReserved5

Must be zero.

dwReserved6

Must be zero.

dwReserved7

Must be zero.

dwReserved8

Must be zero

dwReserved9

Must be zero.

Remarks

The driver allocates this structure and sets appropriate values in all members. The driver's DrvGetDirectDrawInfo function returns a pointer to this structure in the lpD3DHALCallbacks member of the DD_HALINFO structure.

Texture management is now handled though opcodes that are managed in the driver's implementation of D3dDrawPrimitives2.

Requirements

Requirement Value
Header d3dhal.h (include D3dhal.h)

See also

D3DHAL_CALLBACKS3

D3dContextCreate

D3dContextDestroy

D3dDrawPrimitives2

DdGetDriverInfo

DrvGetDirectDrawInfo