IDirect3DDevice9::GetDepthStencilSurface-Methode (d3d9.h)

Ruft die Tiefenschablonenoberfläche ab, die dem Direct3DDevice-Objekt gehört.

Syntax

HRESULT GetDepthStencilSurface(
  [out, retval] IDirect3DSurface9 **ppZStencilSurface
);

Parameter

[out, retval] ppZStencilSurface

Typ: IDirect3DSurface9**

Adresse eines Zeigers auf eine IDirect3DSurface9-Schnittstelle , die die zurückgegebene Tiefenschablonenoberfläche darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn dem Gerät kein Tiefenschablonenpuffer zugeordnet ist, wird der Rückgabewert D3DERR_NOTFOUND. Andernfalls kann der Rückgabewert D3DERR_INVALIDCALL werden, wenn die Methode fehlschlägt.

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

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::SetDepthStencilSurface