D3DHAL_CALLBACKS Struktur (d3dhal.h)

Artikel
02/26/2024

D3DHAL_CALLBACKS ist eine von mehreren Rückrufstrukturen, die die Vom Treiber bereitgestellte Direct3D-Unterstützung beschreiben.

Syntax

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;

Member

dwSize

Gibt die Größe dieser D3DHAL_CALLBACKS-Struktur in Bytes an.

ContextCreate

Verweist auf den vom Treiber bereitgestellten D3dContextCreate-Rückruf . Ein Treiber muss den Rückruf implementieren, auf den dieses Mitglied verweist.

ContextDestroy

Verweist auf den vom Treiber bereitgestellten D3dContextDestroy-Rückruf . Ein Treiber muss den Rückruf implementieren, auf den dieses Mitglied verweist.

ContextDestroyAll

Muss in einem Windows 2000-Treiber und höher auf NULL festgelegt werden.

SceneCapture

Muss in einem Windows 2000-Treiber und höher auf NULL festgelegt werden. Für DirectX 6.0 war dies ein Zeiger auf den vom Treiber bereitgestellten D3dSceneCapture-Rückruf . Für DirectX 7.0 und höher wurde dieser Rückruf durch die Behandlung des D3DRENDERSTATE_SCENECAPTURE Renderzustands in der D3dDrawPrimitives2-Funktion ersetzt.

lpReserved10

Muss Null sein.

lpReserved11

Muss Null sein.

RenderState

Verweist auf den vom Treiber bereitgestellten D3DHAL_RENDERSTATEDATA Rückruf. Ein Treiber muss den Rückruf implementieren, auf den dieses Mitglied verweist.

RenderPrimitive

Verweist auf den vom Treiber bereitgestellten D3DHAL_RENDERPRIMITIVEDATA Rückruf. Ein Treiber muss den Rückruf implementieren, auf den dieses Mitglied verweist.

dwReserved

Gibt reservierte Felder an und muss auf Null festgelegt werden.

TextureCreate

Muss in einem Windows 2000-Treiber und höher auf NULL festgelegt werden. Für DirectX 6.0 war dies ein Zeiger auf den vom Treiber bereitgestellten D3dTextureCreate-Rückruf oder NULL.

TextureDestroy

Muss in einem Windows 2000-Treiber und höher auf NULL festgelegt werden. Für DirectX 6.0 war dies ein Zeiger auf den vom Treiber bereitgestellten D3dTextureDestroy-Rückruf oder NULL.

TextureSwap

Muss in einem Windows 2000-Treiber und höher auf NULL festgelegt werden. Für DirectX 6.0 war dies ein Zeiger auf den vom Treiber bereitgestellten D3dTextureSwap-Rückruf oder NULL.

TextureGetSurf

Muss in einem Windows 2000-Treiber und höher auf NULL festgelegt werden. Für DirectX 6.0 war dies ein Zeiger auf den vom Treiber bereitgestellten D3dTextureGetSurf-Rückruf oder NULL.

lpReserved12

Muss Null sein.

lpReserved13

Muss Null sein.

lpReserved14

Muss Null sein.

lpReserved15

Muss Null sein.

lpReserved16

Muss Null sein.

lpReserved17

Muss Null sein.

lpReserved18

Muss Null sein.

lpReserved19

Muss Null sein.

lpReserved20

Muss Null sein.

lpReserved21

Muss Null sein.

GetState

Verweist auf den vom Treiber bereitgestellten D3DHAL_GETSTATEDATA Rückruf. Ein Treiber muss den Rückruf implementieren, auf den dieses Mitglied verweist.

dwReserved0

Muss Null sein.

dwReserved1

Muss Null sein.

dwReserved2

Muss Null sein.

dwReserved3

Muss Null sein.

dwReserved4

Muss Null sein.

dwReserved5

Muss Null sein.

dwReserved6

Muss Null sein.

dwReserved7

Muss Null sein.

dwReserved8

Muss null sein

dwReserved9

Muss Null sein.

Hinweise

Der Treiber weist diese Struktur zu und legt die entsprechenden Werte in allen Membern fest. Die DrvGetDirectDrawInfo-Funktion des Treibers gibt einen Zeiger auf diese Struktur im element lpD3DHALCallbacks der DD_HALINFO-Struktur zurück.

Die Texturverwaltung wird jetzt über Opcodes abgewickelt, die in der Treiberimplementierung von D3dDrawPrimitives2 verwaltet werden.