IDirect3DDevice9::SetDepthStencilSurface 메서드(d3d9.h)
깊이 스텐실 표면을 설정합니다.
구문
HRESULT SetDepthStencilSurface(
[in] IDirect3DSurface9 *pNewZStencil
);
매개 변수
[in] pNewZStencil
형식: IDirect3DSurface9*
깊이 스텐실 표면을 나타내는 IDirect3DSurface9 인터페이스에 대한 포인터의 주소입니다. 이를 NULL 로 설정하면 깊이 스텐실 작업이 비활성화됩니다.
반환 값
형식: HRESULT
메서드가 성공하면 반환 값이 D3D_OK. pZStencilSurface가 NULL 이외의 경우 스텐실 표면이 유효하지 않으면 반환 값이 D3DERR_INVALIDCALL.
설명
이 메서드 사용에 대한 제한 사항은 다음과 같습니다.
- 다중 샘플 형식은 렌더링 대상 및 깊이 스텐실 표면에 대해 동일해야 합니다.
- 형식은 렌더링 대상 및 깊이 스텐실 표면과 호환되어야 합니다. IDirect3D9::CheckDepthStencilMatch를 참조하세요.
- 깊이 스텐실 표면의 크기는 렌더링 대상의 크기보다 크거나 같아야 합니다.
큐브 텍스처는 표면의 컬렉션이라는 점에서 다른 표면과 다릅니다. 큐브 텍스처로 IDirect3DDevice9::SetDepthStencilSurface 를 호출하려면 IDirect3DCubeTexture9::GetCubeMapSurface 를 사용하여 개별 얼굴을 선택하고 결과 표면을 IDirect3DDevice9::SetDepthStencilSurface에 전달해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | d3d9.h(D3D9.h 포함) |
| 라이브러리 | D3D9.lib |