IDirect3DDevice9::SetDepthStencilSurface-Methode (d3d9helper.h)

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.

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

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::GetDepthStencilSurface