IDirect3DDevice9::GetTextureStageState-Methode (d3d9helper.h)

Artikel
08/23/2023

Ruft einen Zustandswert für eine zugewiesene Textur ab.

Syntax

HRESULT GetTextureStageState(
  [in]          DWORD                    Stage,
  [in]          D3DTEXTURESTAGESTATETYPE Type,
  [out, retval] DWORD                    *pValue
);

Parameter

[in] Stage

Typ: DWORD

Stufenbezeichner der Textur, für die der Zustand abgerufen wird. Phasenbezeichner sind nullbasiert. Geräte können über bis zu acht festgelegte Texturen verfügen, sodass der maximal zulässige Wert für Stage 7 ist.

[in] Type

Typ: D3DTEXTURESTAGESTATETYPE

Texturzustand, der abgerufen werden soll. Dieser Parameter kann ein beliebiges Element des aufgezählten D3DTEXTURESTAGESTATETYPE-Typs sein.

[out, retval] pValue

Typ: DWORD*

Zeiger einer Variablen, die mit dem abgerufenen Zustandswert gefüllt werden soll. Die Bedeutung des abgerufenen Werts wird durch den Type-Parameter bestimmt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Hinweise

Diese Methode gibt keinen Gerätestatus für ein Gerät zurück, das mit D3DCREATE_PUREDEVICE erstellt wird. Wenn Sie diese Methode verwenden möchten, müssen Sie Ihr Gerät mit einem der anderen Flagwerte in D3DCREATE erstellen."