Share via

IDirect3DDevice9::SetDepthStencilSurface-Methode (d3d9.h)

  • Artikel

Legt die Tiefenschablonenoberfläche fest.

Syntax

HRESULT SetDepthStencilSurface(
  [in] IDirect3DSurface9 *pNewZStencil
);

Parameter

[in] pNewZStencil

Typ: IDirect3DSurface9*

Adresse eines Zeigers auf eine IDirect3DSurface9-Schnittstelle , die die Tiefenschablonenoberfläche darstellt. Wenn Sie diesen Wert auf NULL festlegen, wird der Tiefenschablonenvorgang deaktiviert.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn pZStencilSurface nicht NULL ist, wird der Rückgabewert D3DERR_INVALIDCALL, wenn die Schablonenoberfläche ungültig ist.

Hinweise

Einschränkungen für die Verwendung dieser Methode umfassen Folgendes:

  • Der Multisampeltyp muss für das Renderziel und die Tiefenschablonenoberfläche identisch sein.
  • Die Formate müssen für das Renderziel und die Tiefenschablonenoberfläche kompatibel sein. Siehe IDirect3D9::CheckDepthStencilMatch.
  • Die Größe der Tiefenschablonenfläche muss größer oder gleich der Größe des Renderziels sein.
Diese Einschränkungen werden nur überprüft, wenn die Debuglaufzeit verwendet wird, wenn eine der IDirect3DDevice9Draw-Methoden aufgerufen wird.

Cubetexturen unterscheiden sich von anderen Oberflächen darin, dass es sich um Sammlungen von Oberflächen handelt. Um IDirect3DDevice9::SetDepthStencilSurface mit einer Cubetextur aufzurufen, müssen Sie mithilfe von IDirect3DCubeTexture9::GetCubeMapSurface ein einzelnes Gesicht auswählen und die resultierende Oberfläche an IDirect3DDevice9::SetDepthStencilSurface übergeben.

Anforderungen

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

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::GetDepthStencilSurface