D3DHAL_CALLBACKS Struktur (d3dhal.h)

Artikel
02/06/2025

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;

Angehörige

dwSize

Gibt die Größe in Byte dieser D3DHAL_CALLBACKS Struktur 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 auf NULL- in einem Windows 2000- und höher-Treiber festgelegt werden.

SceneCapture

Muss auf NULL- in einem Windows 2000- und höher-Treiber 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 auf NULL- in einem Windows 2000- und höher-Treiber festgelegt werden. Für DirectX 6.0 war dies ein Zeiger auf den vom Treiber bereitgestellten D3dTextureCreate Callback oder NULL-.

TextureDestroy

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

TextureSwap

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

TextureGetSurf

Muss auf NULL- in einem Windows 2000- und höher-Treiber 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.

Bemerkungen

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

Die Texturverwaltung wird jetzt behandelt, obwohl Opcodes, die in der Implementierung von D3dDrawPrimitives2verwaltet werden.