Freigeben über


IDirect3DDevice9::GetTexture-Methode (d3d9.h)

Ruft eine Textur ab, die einer Phase für ein Gerät zugewiesen ist.

Syntax

HRESULT GetTexture(
  [in]          DWORD                 Stage,
  [out, retval] IDirect3DBaseTexture9 **ppTexture
);

Parameter

[in] Stage

Typ: DWORD

Phasenbezeichner der abzurufenden Textur. Phasenbezeichner sind nullbasiert.

[out, retval] ppTexture

Typ: IDirect3DBaseTexture9**

Adresse eines Zeigers auf eine IDirect3DBaseTexture9-Schnittstelle , die die zurückgegebene Textur darstellt.

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

Methoden, die den Zustand zurückgeben, funktionieren in der Regel nicht auf einem Gerät, das mit D3DCREATE_PUREDEVICE erstellt wird. Diese Methode funktioniert jedoch auch auf einem reinen Gerät, da sie eine Schnittstelle zurückgibt.

Wenn Sie diese Methode aufrufen, wird die anzahl der internen Verweise auf der IDirect3DTexture9-Schnittstelle erhöht. Wenn IUnknown::Release nicht aufgerufen wird, wenn die Verwendung dieser IDirect3DTexture9-Schnittstelle abgeschlossen ist, kommt es zu einem Speicherverlust.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d9.h (einschließlich D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::GetTextureStageState

IDirect3DDevice9::SetTexture

IDirect3DDevice9::SetTextureStageState