Metode IDirect3DDevice9::SetDepthStencilSurface (d3d9.h)

  • Artikel

Mengatur permukaan stensil kedalaman.

Sintaks

HRESULT SetDepthStencilSurface(
  [in] IDirect3DSurface9 *pNewZStencil
);

Parameter

[in] pNewZStencil

Jenis: IDirect3DSurface9*

Alamat penunjuk ke antarmuka IDirect3DSurface9 yang mewakili permukaan stensil kedalaman. Mengatur ini ke NULL menonaktifkan operasi stensil kedalaman.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika pZStencilSurface selain NULL, nilai yang dikembalikan D3DERR_INVALIDCALL ketika permukaan stensil tidak valid.

Keterangan

Pembatasan untuk menggunakan metode ini meliputi yang berikut ini:

  • Jenis multisample harus sama untuk target render dan permukaan stensil kedalaman.
  • Format harus kompatibel untuk target render dan permukaan stensil kedalaman. Lihat IDirect3D9::CheckDepthStencilMatch.
  • Ukuran permukaan stensil kedalaman harus lebih besar dari atau sama dengan ukuran target render.
Pembatasan ini hanya divalidasi saat menggunakan runtime debug saat salah satu metode IDirect3DDevice9Draw dipanggil.

Tekstur kubus berbeda dari permukaan lain karena mereka adalah koleksi permukaan. Untuk memanggil IDirect3DDevice9::SetDepthStencilSurface dengan tekstur kubus, Anda harus memilih wajah individual menggunakan IDirect3DCubeTexture9::GetCubeMapSurface dan meneruskan permukaan yang dihasilkan ke IDirect3DDevice9::SetDepthStencilSurface.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d9.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

IDirect3DDevice9

IDirect3DDevice9::GetDepthStencilSurface