IDirect3DDevice9::GetTexture-Methode (d3d9helper.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
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9helper.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |