IDirect3DDevice9::GetTexture-Methode (d3d9helper.h)

Artikel
08/23/2023

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

Stufenbezeichner 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.

Durch Aufrufen dieser Methode wird die interne Verweisanzahl auf der IDirect3DTexture9-Schnittstelle erhöht. Fehler beim Aufrufen von IUnknown::Release nach Abschluss der Verwendung dieser IDirect3DTexture9-Schnittstelle führt zu einem Speicherverlust.