D3DHAL_CALLBACKS3 Struktur (d3dhal.h)

Artikel
02/06/2025

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

Syntax

typedef struct _D3DHAL_CALLBACKS3 {
  DWORD                                dwSize;
  DWORD                                dwFlags;
  LPD3DHAL_CLEAR2CB                    Clear2;
  LPVOID                               lpvReserved;
  LPD3DHAL_VALIDATETEXTURESTAGESTATECB ValidateTextureStageState;
  LPD3DHAL_DRAWPRIMITIVES2CB           DrawPrimitives2;
} D3DHAL_CALLBACKS3, *LPD3DHAL_CALLBACKS3;

Angehörige

dwSize

Gibt die Größe in Byte dieser Struktur an.

dwFlags

Gibt die Rückrufe an, die dieser Struktur zugeordnet sind, die der Treiber implementiert hat. Für jedes Bit, das der Treiber in dwFlagsfestlegt, muss der Treiber das entsprechende Funktionszeigerelement dieser Struktur initialisieren. Dieses Element kann die bitweise OR einer oder mehrerer der folgenden Flags sein:

Kennzeichnung	Bedeutung
D3DHAL3_CB32_CLEAR2	Wird in DirectX 7.0 und höheren Versionen nicht verwendet.
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member verweist auf einen treiberbasierten D3dDrawPrimitives2 Rückruf.
D3DHAL3_CB32_RESERVED	Wird in DirectX 7.0 und höheren Versionen nicht verwendet.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	Die ValidateTextureStageStatemember verweist auf einen treiber implementierten D3dValidateTextureStageState Rückruf.

Clear2

Muss auf NULL-festgelegt sein. Dies war ein Zeiger auf den vom Treiber bereitgestellten D3dClear2 Rückruf, der nicht mehr für DirectX 7.0 und darüber hinaus verwendet wird. Stattdessen sollte der Treiber auf das D3DDP2OP_CLEAR Befehlsdatenstromtoken in seiner Implementierung von D3dDrawPrimitives2reagieren.

lpvReserved

Gibt ein reserviertes Feld an und muss auf NULL- in einem Windows 2000- und höher-Treiber festgelegt werden.

ValidateTextureStageState

Verweist auf den vom Treiber bereitgestellten D3dValidateTextureStageState Rückruf oder NULL-. Treiber, die multitexturing unterstützen, müssen den Rückruf implementieren, auf den dieses Element verweist.

DrawPrimitives2

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

Bemerkungen

Der Treiber weist diese Struktur zu und legt entsprechende Werte in allen Membern fest. Die DdGetDriverInfo--Funktion des Treibers gibt einen Zeiger auf diese Struktur zurück, wenn diese Funktion mit der GUID_D3DCallbacks3 GUID aufgerufen wird.