D3DHAL_CALLBACKS3 Struktur (d3dhal.h)

Artikel
02/23/2024

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;

Member

dwSize

Gibt die Größe dieser Struktur in Byte 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 dwFlags festlegt, muss der Treiber den entsprechenden Funktionszeigermember dieser Struktur initialisieren. Dieser Member kann das bitweise OR eines oder mehrerer der folgenden Flags sein:

Kennzeichnen	Bedeutung
D3DHAL3_CB32_CLEAR2	Wird in DirectX 7.0 und höheren Versionen nicht verwendet.
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member verweist auf einen vom Treiber implementierten D3dDrawPrimitives2-Rückruf .
D3DHAL3_CB32_RESERVED	Wird in DirectX 7.0 und höheren Versionen nicht verwendet.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	ValidateTextureStageStatemember verweist auf einen vom Treiber implementierten D3dValidateTextureStageState-Rückruf .

Clear2

Muss auf NULL festgelegt werden. Dies war ein Zeiger auf den vom Treiber bereitgestellten D3dClear2-Rückruf , der für DirectX 7.0 und höher nicht mehr verwendet wird. Stattdessen sollte der Treiber auf das D3DDP2OP_CLEAR Befehlsstreamtokens in seiner Implementierung von D3dDrawPrimitives2 reagieren.

lpvReserved

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

ValidateTextureStageState

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

DrawPrimitives2

Verweist auf den vom Treiber bereitgestellten D3dDrawPrimitives2-Rückruf . Ein Treiber muss den Rückruf implementieren, auf den dieser Member verweist.

Hinweise

Der Treiber ordnet diese Struktur zu und legt die entsprechenden 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.