structure D3DHAL_CALLBACKS (d3dhal.h)

D3DHAL_CALLBACKS est l’une des structures de rappel qui décrivent la prise en charge 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 auquel ce membre pointe.

ContextDestroy

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

ContextDestroyAll

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

SceneCapture

Doit être défini sur NULL dans un pilote Windows 2000 et ultérieur. 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 égal à zéro.

lpReserved11

Doit être égal à zéro.

RenderState

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

RenderPrimitive

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

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 ultérieur. 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 ultérieur. Pour DirectX 6.0, il s’agissait d’un pointeur vers le D3dTextureDestroy fourni par le pilote rappel, ou NULL.

TextureSwap

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

TextureGetSurf

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

lpReserved12

Doit être égal à zéro.

lpReserved13

Doit être égal à zéro.

lpReserved14

Doit être égal à zéro.

lpReserved15

Doit être égal à zéro.

lpReserved16

Doit être égal à zéro.

lpReserved17

Doit être égal à zéro.

lpReserved18

Doit être égal à zéro.

lpReserved19

Doit être égal à zéro.

lpReserved20

Doit être égal à zéro.

lpReserved21

Doit être égal à zéro.

GetState

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

dwReserved0

Doit être égal à zéro.

dwReserved1

Doit être égal à zéro.

dwReserved2

Doit être égal à zéro.

dwReserved3

Doit être égal à zéro.

dwReserved4

Doit être égal à zéro.

dwReserved5

Doit être égal à zéro.

dwReserved6

Doit être égal à zéro.

dwReserved7

Doit être égal à zéro.

dwReserved8

Doit être égal à zéro

dwReserved9

Doit être égal à 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 lpD3DHALCallbacks membre 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.

Exigences

Voir aussi

D3DHAL_CALLBACKS3

D3dContextCreate

D3dContextDestroy

D3dDrawPrimitives2

DdGetDriverInfo

DrvGetDirectDrawInfo