IDirect3DDevice9::CreateDepthStencilSurface 메서드

스텐실 리소스를 생성 한다.

구문

HRESULT CreateDepthStencilSurface(      

    UINT Width,
    UINT Height,
    D3DFORMAT Format,
    D3DMULTISAMPLE_TYPE MultiSample,
    DWORD MultisampleQuality,
    BOOL Discard,
    IDirect3DSurface9** ppSurface,
    HANDLE* pHandle
);

파라미터

Width
[in] 스텐실 표면의 폭 (픽셀 단위).
Height
[in] 스텐실 표면의 높이 (픽셀 단위).
Format
[in] D3DFORMAT 열거형의 멤버. 스텐실 표면의 포맷을 기술한다. 이 값은, 그 장치에 대해서 열거된 스텐실 포맷의 1 개가 아니면 안된다.
MultiSample
[in] D3DMULTISAMPLE_TYPE 열거형의 멤버. 멀티 샘플링 버퍼 타입을 기술한다. 이 값은, 사용할 수 있는 멀티 샘플링 타입의 1 개가 아니면 안된다. 이 표면을 IDirect3DDevice9::SetDepthStencilSurface 에 건네줄 때는, 멀티 샘플링 타입이,IDirect3DDevice9::SetRenderTarget 로 설정된 렌더링 타겟의 것과 같지 않으면 안 된다.
MultisampleQuality
[in] 품질 레벨. 유효 범위는, 0 으로부터,IDirect3D9::CheckDeviceMultiSampleType 로 사용하는 pQualityLevels 에 돌려받는 레벨로부터 1 을 뺀 값까지이다. 이것보다 큰 값을 건네주면 에러 D3DERR_INVALIDCALL 가 반환된다. 페어로 된 렌더링 타겟과 스텐실 표면의 MultisampleQuality 값, MultiSample 타입이, 모두 일치하고 있을 필요가 있다.
Discard
[in] 이 플래그는, z 버퍼의 파기를 유효하게 하는 경우는 TRUE 에, 그 이외의 경우는 FALSE 로 설정한다.
이 플래그를 설정했을 경우, 다른 깊이 표면으로 IDirect3DDevice9::Present 또는 IDirect3DDevice9::SetDepthStencilSurface 를 호출하면, 스텐실 버퍼의 내용이 무효가 된다.
이 플래그는,D3DPRESENTFLAG 의 정수 D3DPRESENTFLAG_DISCARD_DEPTHSTENCIL 와 같은 동작을 한다.
ppSurface
[out, retval] 생성 된 스텐실 표면 리소스를 나타내는 IDirect3DSurface9 인터페이스의 포인터 주소.
pHandle
[in] 예약이 끝난 상태. 이 파라미터는 NULL 로 설정한다.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.

D3DERR_NOTAVAILABLE 이 장치는, 조회된 멀티 샘플 타입을 지원 하고 있지 않다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DERR_OUTOFVIDEOMEMORY Microsoft® Direct3D® 가 처리를 실시하는데 충분한 디스플레이 메모리가 없다.
E_OUTOFMEMORY Direct3D 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

주의

스텐실 버퍼의 메모리 클래스는, 항상 D3DPOOL_DEFAULT 이다.

참조

IDirect3DDevice9::UpdateSurface

D3DERR_NOTAVAILABLE	이 장치는, 조회된 멀티 샘플 타입을 지원 하고 있지 않다.
D3DERR_INVALIDCALL	메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DERR_OUTOFVIDEOMEMORY	Microsoft® Direct3D® 가 처리를 실시하는데 충분한 디스플레이 메모리가 없다.
E_OUTOFMEMORY	Direct3D 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.