IDirect3DDevice9::GetRenderTargetData 메서드(d3d9helper.h)
렌더링 대상 데이터를 디바이스 메모리에서 시스템 메모리로 복사합니다.
구문
HRESULT GetRenderTargetData(
[in] IDirect3DSurface9 *pRenderTarget,
[in] IDirect3DSurface9 *pDestSurface
);
매개 변수
[in] pRenderTarget
형식: IDirect3DSurface9*
렌더링 대상을 나타내는 IDirect3DSurface9 개체에 대한 포인터입니다.
[in] pDestSurface
형식: IDirect3DSurface9*
대상 표면을 나타내는 IDirect3DSurface9 개체에 대한 포인터입니다.
반환 값
형식: HRESULT
메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL 중 하나일 수 있습니다.
설명
대상 표면은 오프 스크린 일반 표면이거나 D3DPOOL_SYSTEMMEM 사용하여 만든 텍스처 수준(mipmap 또는 큐브 텍스처)이어야 합니다.
원본 표면은 일반 렌더링 대상 또는 POOL_DEFAULT 사용하여 만든 렌더링 대상 텍스처(mipmap 또는 큐브 텍스처)의 수준이어야 합니다.
다음과 같은 경우 이 메서드가 실패합니다.
- 렌더링 대상은 다중 샘플링됩니다.
- 원본 렌더링 대상은 대상 표면과 다른 크기입니다.
- 원본 렌더링 대상 및 대상 표면 형식이 일치하지 않습니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | d3d9helper.h(D3D9.h 포함) |
라이브러리 | D3D9.lib |