structure D3DHAL_CALLBACKS (d3dhal.h)

Article
02/23/2024

D3DHAL_CALLBACKS est l’une des nombreuses structures de rappel qui décrivent la prise en charge de Direct3D fournie par le pilote.

Syntaxe

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;

Membres

dwSize

Spécifie la taille en octets de cette structure D3DHAL_CALLBACKS.

ContextCreate

Pointe vers le rappel D3dContextCreate fourni par le pilote. Un pilote doit implémenter le rappel vers lequel pointe ce membre.

ContextDestroy

Pointe vers le rappel D3dContextDestroy fourni par le pilote. Un pilote doit implémenter le rappel vers lequel pointe ce membre.

ContextDestroyAll

Doit être défini sur NULL dans un pilote Windows 2000 et versions ultérieures.

SceneCapture

Doit être défini sur NULL dans un pilote Windows 2000 et versions ultérieures. Pour DirectX 6.0, il s’agissait d’un pointeur vers le rappel D3dSceneCapture fourni par le pilote. Pour DirectX 7.0 et versions ultérieures, ce rappel a été remplacé par la gestion de l’état de rendu D3DRENDERSTATE_SCENECAPTURE dans la fonction D3dDrawPrimitives2 .

lpReserved10

Doit être zéro.

lpReserved11

Doit être zéro.

RenderState

Pointe vers le rappel D3DHAL_RENDERSTATEDATA fourni par le pilote. Un pilote doit implémenter le rappel vers lequel pointe ce membre.

RenderPrimitive

Pointe vers le rappel D3DHAL_RENDERPRIMITIVEDATA fourni par le pilote. Un pilote doit implémenter le rappel vers lequel pointe ce membre.

dwReserved

Spécifie les champs réservés et doit être défini sur zéro.

TextureCreate

Doit être défini sur NULL dans un pilote Windows 2000 et versions ultérieures. Pour DirectX 6.0, il s’agissait d’un pointeur vers le rappel D3dTextureCreate fourni par le pilote, ou NULL.

TextureDestroy

Doit être défini sur NULL dans un pilote Windows 2000 et versions ultérieures. Pour DirectX 6.0, il s’agissait d’un pointeur vers le rappel D3dTextureDestroy fourni par le pilote ou NULL.

TextureSwap

Doit être défini sur NULL dans un pilote Windows 2000 et versions ultérieures. Pour DirectX 6.0, il s’agissait d’un pointeur vers le rappel D3dTextureSwap fourni par le pilote, ou NULL.

TextureGetSurf

Doit être défini sur NULL dans un pilote Windows 2000 et versions ultérieures. Pour DirectX 6.0, il s’agissait d’un pointeur vers le rappel D3dTextureGetSurf fourni par le pilote, ou NULL.

lpReserved12

Doit être zéro.

lpReserved13

Doit être zéro.

lpReserved14

Doit être zéro.

lpReserved15

Doit être zéro.

lpReserved16

Doit être zéro.

lpReserved17

Doit être zéro.

lpReserved18

Doit être zéro.

lpReserved19

Doit être zéro.

lpReserved20

Doit être zéro.

lpReserved21

Doit être zéro.

GetState

Pointe vers le rappel D3DHAL_GETSTATEDATA fourni par le pilote. Un pilote doit implémenter le rappel vers lequel pointe ce membre.

dwReserved0

Doit être zéro.

dwReserved1

Doit être zéro.

dwReserved2

Doit être zéro.

dwReserved3

Doit être zéro.

dwReserved4

Doit être zéro.

dwReserved5

Doit être zéro.

dwReserved6

Doit être zéro.

dwReserved7

Doit être zéro.

dwReserved8

Doit être égal à zéro

dwReserved9

Doit être zéro.

Remarques

Le pilote alloue cette structure et définit les valeurs appropriées dans tous les membres. La fonction DrvGetDirectDrawInfo du pilote retourne un pointeur vers cette structure dans le membre lpD3DHALCallbacks de la structure DD_HALINFO .

La gestion des textures est désormais gérée par des opcodes gérés dans l’implémentation du pilote de D3dDrawPrimitives2.