Freigeben über


IDirect3DTexture9::GetSurfaceLevel-Methode (d3d9.h)

Ruft die angegebene Texturoberflächenebene ab.

Syntax

HRESULT GetSurfaceLevel(
  [in]          UINT              Level,
  [out, retval] IDirect3DSurface9 **ppSurfaceLevel
);

Parameter

[in] Level

Typ: UINT

Gibt eine Ebene der Texturressource an. Diese Methode gibt eine Oberfläche für die mit diesem Parameter angegebene Ebene zurück. Die Oberfläche der obersten Ebene wird durch 0 bezeichnet.

[out, retval] ppSurfaceLevel

Typ: IDirect3DSurface9**

Adresse eines Zeigers auf eine IDirect3DSurface9-Schnittstelle , die die zurückgegebene Oberfläche 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 ein D3DERR_INVALIDCALL sein.

Hinweise

Durch Aufrufen dieser Methode wird die interne Verweisanzahl auf der IDirect3DSurface9-Schnittstelle erhöht. Fehler beim Aufrufen von IUnknown::Release , wenn die Verwendung dieser IDirect3DSurface9-Schnittstelle abgeschlossen ist, führt zu einem Speicherverlust.

Anforderungen

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

Weitere Informationen

IDirect3DTexture9