IDirect3DDevice9::SetRenderTarget 메서드

장치에 새로운 컬러 버퍼를 설정한다.

구문

HRESULT SetRenderTarget(      

    DWORD RenderTargetIndex,
    IDirect3DSurface9 *pRenderTarget
);

파라미터

RenderTargetIndex

[in] 렌더링 타겟의 인덱스. 「주의」를 참조할것.

pRenderTarget

[in] 새로운 컬러 버퍼의 포인터. NULL 의 경우, 대응하는 RenderTargetIndex 의 컬러 버퍼는 무효가 된다. 이 파라미터가 NULL 이외의 경우는, 새로운 렌더링 타겟의 참조 카운트가 인크리먼트(increment) 된다. 장치에는, 항상, 컬러 버퍼를 관련지을 수 있지 않으면 안 된다.

새로운 렌더링 타겟의 표면에는, 적어도 D3DUSAGE_RENDERTARGET 가 지정되지 않으면 안 된다.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.

다음의 몇개의 경우는 D3DERR_INVALIDCALL 를 돌려준다.

• pRenderTarget 가 NULL 로 RenderTargetIndex 가 0 의 경우.
• pRenderTarget 가 NULL 가 아니고, 렌더링 타겟이 무효의 경우.

주의

장치는, 복수의 렌더링 타겟을 지원 할 수 있는이 되었다. 장치가 지원 하는 렌더링 타겟의 수는,D3DCAPS9 의 NumSimultaneousRTs 멤버에 저장 되고 있다. 「복수의 렌더링 타겟」을 참조할것.

일부의 하드웨어에서는, 스텐실 버퍼와 컬러 버퍼의 호환성을 테스트한다. 테스트가 실행되는 경우는, 디버그 빌드로 밖에 실행할 수 없다.

이 메서드의 사용에 관한 제약을 다음에 나타낸다.

• 렌더링 타겟과 스텐실 표면은, 멀티 샘플링 타입이 같지 않으면 안 된다.
• 렌더링 타겟과 스텐실 표면은, 포맷이 호환이 아니면 안된다. 「IDirect3D9::CheckDepthStencilMatch 」를 참조할것.
• 스텐실 표면의 사이즈는, 렌더링 타겟의 사이즈 이상이 아니면 안된다.

이러한 제약은, 디버그 런타임 사용시에만 IDirect3DDevice9  의 Draw 메서드를 호출했을 때에 검증된다.

큐브 텍스처는, 표면의 집합인 점이 다른 표면와 다르다. 큐브 텍스처를 지정해 IDirect3DDevice9::SetRenderTarget 을 호출하려면 ,IDirect3DCubeTexture9::GetCubeMapSurface 를 사용해 특정의 면을 선택해, 그 표면을 IDirect3DDevice9::SetRenderTarget 에 건네줄 필요가 있다.