IDirect3DDevice9::SetDepthStencilSurface-Methode (d3d9helper.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 die Tiefenschablonenoperation deaktiviert.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn pZStencilSurface einen anderen Wert als NULL aufweist, 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 Tiefenschablonenoberfläche muss größer oder gleich der Größe des Renderziels sein.
Diese Einschränkungen werden nur überprüft, wenn die Debugruntime verwendet wird, wenn eine der IDirect3DDevice9Draw-Methoden aufgerufen wird.

Würfeltexturen unterscheiden sich von anderen Oberflächen darin, dass es sich um Oberflächensammlungen handelt. Um IDirect3DDevice9::SetDepthStencilSurface mit einer Würfeltextur 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 d3d9helper.h (include D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::GetDepthStencilSurface