D3DHAL_CALLBACKS struttura (d3dhal.h)

Articolo
02/25/2024

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;

Members

dwSize

Specifica le dimensioni in byte di questa struttura D3DHAL_CALLBACKS.

ContextCreate

Punta al callback D3dContext Fornito dal 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, questo era un puntatore al callback D3dSceneCapture fornito dal driver. 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 fornito dal driver D3DHAL_RENDERSTATEDATA. Un driver deve implementare il callback a cui punta questo membro.

RenderPrimitive

Punta al callback fornito dal driver D3DHAL_RENDERPRIMITIVEDATA. 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, questo era un puntatore al driver fornito da D3dTextureCrea callback o NULL.

TextureDestroy

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

TextureSwap

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

TextureGetSurf

Deve essere impostato su NULL in un driver Windows 2000 e versioni successive. Per DirectX 6.0, questo era un puntatore al callback D3dTextureGetSurf fornito dal driver o 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 fornito dal driver D3DHAL_GETSTATEDATA. 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.

Commenti

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 nel membro lpD3DHALCallbacks della struttura DD_HALINFO .

La gestione delle trame è ora gestita anche se i codici opcode gestiti nell'implementazione del driver di D3dDrawPrimitives2.