IDirect3DDevice9::SetDepthStencilSurface 메서드(d3d9helper.h)

깊이 스텐실 표면을 설정합니다.

구문

HRESULT SetDepthStencilSurface(
  [in] IDirect3DSurface9 *pNewZStencil
);

매개 변수

[in] pNewZStencil

형식: IDirect3DSurface9*

깊이 스텐실 표면을 나타내는 IDirect3DSurface9 인터페이스에 대한 포인터의 주소입니다. 이를 NULL 로 설정하면 깊이 스텐실 작업이 비활성화됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. pZStencilSurface가 NULL 이외의 경우 스텐실 표면이 유효하지 않으면 반환 값이 D3DERR_INVALIDCALL.

설명

이 메서드 사용에 대한 제한 사항은 다음과 같습니다.

• 다중 샘플 형식은 렌더링 대상 및 깊이 스텐실 표면에 대해 동일해야 합니다.
• 형식은 렌더링 대상 및 깊이 스텐실 표면과 호환되어야 합니다. IDirect3D9::CheckDepthStencilMatch를 참조하세요.
• 깊이 스텐실 표면의 크기는 렌더링 대상의 크기보다 크거나 같아야 합니다.

이러한 제한 사항은 IDirect3DDevice9Draw 메서드가 호출될 때 디버그 런타임을 사용하는 경우에만 유효성을 검사합니다.

큐브 텍스처는 표면의 컬렉션이라는 점에서 다른 표면과 다릅니다. 큐브 텍스처로 IDirect3DDevice9::SetDepthStencilSurface 를 호출하려면 IDirect3DCubeTexture9::GetCubeMapSurface 를 사용하여 개별 얼굴을 선택하고 결과 표면을 IDirect3DDevice9::SetDepthStencilSurface에 전달해야 합니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	d3d9helper.h(D3D9.h 포함)
라이브러리	D3D9.lib

추가 정보

IDirect3DDevice9

IDirect3DDevice9::GetDepthStencilSurface