IDirect3DDevice9::GetRenderTargetData 메서드

렌더링 타겟 데이터를 장치 메모리로부터 시스템 메모리에 복사 한다.

구문

HRESULT GetRenderTargetData(      

    IDirect3DSurface9* pRenderTarget,
    IDirect3DSurface9* pDestSurface
);

파라미터

pRenderTarget
[in] 렌더링 타겟을 나타내는 IDirect3DSurface9 개체의 포인터.
pDestSurface
[in] 목적지 표면을 나타내는 IDirect3DSurface9 개체의 포인터.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.
인수중 한쪽이 무효인 경우는,D3DERR_INVALIDCALL 가 된다.

주의

목적지 표면은, D3DPOOL_SYSTEMMEM 로 생성 한 오프 스크린 플레인 표면 또는 텍스처 레벨 (밉맵 또는 큐브 텍스처)이 아니면 안된다.
전송원표면은, POOL_DEFAULT 로 생성 한 보통의 렌더링 타겟 또는 렌더링 타겟 텍스처의 레벨 (밉맵 또는 큐브 텍스처)이 아니면 안된다.
다음의 경우, 메서드는 실패한다.
렌더링 타겟이 멀티 샘플링 되었을 경우.
전송원렌더링 타겟이 목적지 표면의 사이즈와 다른 경우.
전송원렌더링 타겟과 목적지 표면의 포맷이 일치하지 않는 경우.