struttura D3DHAL_CALLBACKS (d3dhal.h)

Articolo
02/06/2025

D3DHAL_CALLBACKS è una delle diverse strutture di callback che descrivono il supporto Direct3D fornito dal driver.

Sintassi

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;

Membri

dwSize

Specifica le dimensioni in byte di questa struttura D3DHAL_CALLBACKS.

ContextCreate

Punta al callback D3dContextCreate driver. Un driver deve implementare il callback a cui punta questo membro.

ContextDestroy

Punta al callback D3dContextDestroy fornito dal driver. Un driver deve implementare il callback a cui punta questo membro.

ContextDestroyAll

Deve essere impostato su NULL in un driver Windows 2000 e versioni successive.

SceneCapture

Deve essere impostato su NULL in un driver Windows 2000 e versioni successive. Per DirectX 6.0, si tratta di un puntatore al callback fornito dal driver D3dSceneCapture. Per DirectX 7.0 e versioni successive, questo callback è stato sostituito dalla gestione dello stato di rendering D3DRENDERSTATE_SCENECAPTURE nella funzione D3dDrawPrimitives2.

lpReserved10

Deve essere zero.

lpReserved11

Deve essere zero.

RenderState

Punta al callback D3DHAL_RENDERSTATEDATA fornito dal driver. Un driver deve implementare il callback a cui punta questo membro.

RenderPrimitive

Punta al callback D3DHAL_RENDERPRIMITIVEDATA fornito dal driver. Un driver deve implementare il callback a cui punta questo membro.

dwReserved

Specifica i campi riservati e deve essere impostato su zero.

TextureCreate

Deve essere impostato su NULL in un driver Windows 2000 e versioni successive. Per DirectX 6.0, si tratta di un puntatore al driver fornito D3dTextureCreate callback o NULL.

TextureDestroy

Deve essere impostato su NULL in un driver Windows 2000 e versioni successive. Per DirectX 6.0, si tratta di un puntatore al driver fornito D3dTextureDestroy callback o NULL.

TextureSwap

Deve essere impostato su NULL in un driver Windows 2000 e versioni successive. Per DirectX 6.0, si tratta di un puntatore al driver fornito D3dTextureSwap callback o NULL.

TextureGetSurf

Deve essere impostato su NULL in un driver Windows 2000 e versioni successive. Per DirectX 6.0, si tratta di un puntatore al callback D3dTextureGetSur f fornito dal driver oppure NULL.

lpReserved12

Deve essere zero.

lpReserved13

Deve essere zero.

lpReserved14

Deve essere zero.

lpReserved15

Deve essere zero.

lpReserved16

Deve essere zero.

lpReserved17

Deve essere zero.

lpReserved18

Deve essere zero.

lpReserved19

Deve essere zero.

lpReserved20

Deve essere zero.

lpReserved21

Deve essere zero.

GetState

Punta al callback D3DHAL_GETSTATEDATA fornito dal driver. Un driver deve implementare il callback a cui punta questo membro.

dwReserved0

Deve essere zero.

dwReserved1

Deve essere zero.

dwReserved2

Deve essere zero.

dwReserved3

Deve essere zero.

dwReserved4

Deve essere zero.

dwReserved5

Deve essere zero.

dwReserved6

Deve essere zero.

dwReserved7

Deve essere zero.

dwReserved8

Deve essere zero

dwReserved9

Deve essere zero.

Osservazioni

Il driver alloca questa struttura e imposta i valori appropriati in tutti i membri. La funzione drvGetDirectDrawInfo del driver restituisce un puntatore a questa struttura nell'lpD3DHALCallbacks membro della struttura DD_HALINFO.

La gestione delle trame viene ora gestita tramite opcode gestiti nell'implementazione del driver di D3dDrawPrimitives2.