Share via

D3DHAL_CALLBACKS

  • Article

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

typedef struct _D3DHAL_CALLBACKS {
  DWORD dwSize;
  // Device context
  LPD3DHAL_CONTEXTCREATECB ContextCreate;
  LPD3DHAL_CONTEXTDESTROYCB ContextDestroy;
  LPD3DHAL_CONTEXTDESTROYALLCB  ContextDestroyAll;
  // Scene Capture
  LPD3DHAL_SCENECAPTURECB SceneCapture;
  // Execution
  LPVOID dwReserved10;
  LPVOID dwReserved11;
  LPVOID dwReserved22;
  LPVOID dwReserved23;
  ULONG_PTR dwReserved;
  // Textures
  LPD3DHAL_TEXTURECREATECB TextureCreate;
  LPD3DHAL_TEXTUREDESTROYCB TextureDestroy;
  LPD3DHAL_TEXTURESWAPCB TextureSwap;
  LPD3DHAL_TEXTUREGETSURFCB TextureGetSurf;
  LPVOID dwReserved12;
  LPVOID dwReserved13;
  LPVOID dwReserved14;
  LPVOID dwReserved15;
  LPVOID dwReserved16;
  LPVOID dwReserved17;
  LPVOID dwReserved18;
  LPVOID dwReserved19;
  LPVOID dwReserved20;
  LPVOID dwReserved21;
  // Pipeline state
  LPVOID dwReserved24;
  ULONG_PTR dwReserved0;
  ULONG_PTR dwReserved1;
  ULONG_PTR dwReserved2;
  ULONG_PTR dwReserved3;
  ULONG_PTR dwReserved4;
  ULONG_PTR dwReserved5;
  ULONG_PTR dwReserved6;
  ULONG_PTR dwReserved7;
  ULONG_PTR dwReserved8;
  ULONG_PTR 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 CE .NET and later driver.
  • SceneCapture
    Must be set to NULL in a Windows CE .NET and later driver. This was a pointer to the driver-supplied D3dSceneCapture callback that was replaced by the D3DRENDERSTATE_SCENECAPTURE render state. This render state is handled in D3dDrawPrimitives2.
  • dwReserved10, dwReserved11, dwReserved22, dwReserved23, dwReserved
    Are reserved and must be set to zero.
  • TextureCreate
    Must be set to NULL in a Windows CE .NET and later driver. This was a pointer to the driver-supplied D3dTextureCreate callback, or NULL.
  • TextureDestroy
    Must be set to NULL in a Windows CE .NET and later driver. This was a pointer to the driver-supplied D3dTextureDestroy callback, or NULL.
  • TextureSwap
    Must be set to NULL in a Windows CE .NET and later driver. This was a pointer to the driver-supplied D3dTextureSwap callback, or NULL.
  • TextureGetSurf
    Must be set to NULL in a Windows CE .NET and later driver. This was a pointer to the driver-supplied D3dTextureGetSurf callback, or NULL.
  • dwReserved12 - dwReserved21, dwReserved24, dwReserved0 - dwReserved9
    Are reserved and must be set to zero.

Remarks

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

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

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3dhal.h.

See Also

D3dContextCreate | D3dContextDestroy | D3DRENDERSTATE_SCENECAPTURE | DDHALINFO | D3dDrawPrimitives2 | HALInit | GetDriverInfo | D3DHAL_CALLBACKS3 | D3DHAL_XXX Structures

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.