IDirect3DDevice9::GetRenderTarget 메서드(d3d9helper.h)

렌더링 대상 표면을 검색합니다.

구문

HRESULT GetRenderTarget(
  [in]  DWORD             RenderTargetIndex,
  [out] IDirect3DSurface9 **ppRenderTarget
);

[in] RenderTargetIndex

형식: DWORD

렌더링 대상의 인덱스입니다. 설명 부분을 참조하세요.

[out] ppRenderTarget

이 디바이스에 대해 반환된 렌더링 대상 표면을 나타내는 IDirect3DSurface9 인터페이스에 대한 포인터의 주소입니다.

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 인수 중 하나가 잘못된 경우 반환 값을 D3DERR_INVALIDCALL, 지정된 인덱스에서 사용할 수 있는 렌더링 대상이 없는 경우 D3DERR_NOTFOUND 수 있습니다.

일반적으로 상태를 반환하는 메서드는 D3DCREATE_PUREDEVICE 사용하여 만든 디바이스에서 작동하지 않습니다. 그러나 이 메서드는 인터페이스를 반환하므로 순수 디바이스에서도 작동합니다.

이제 디바이스에서 여러 렌더링 대상을 지원할 수 있습니다. 디바이스에서 지원하는 렌더링 대상의 수는 D3DCAPS9 NumSimultaneousRTs 멤버에 포함되어 있습니다. 여러 렌더링 대상(Direct3D 9)을 참조하세요.

이 메서드를 호출하면 IDirect3DSurface9 인터페이스의 내부 참조 수가 증가합니다. IDirect3DSurface9 인터페이스 사용을 마쳤을 때 IUnknown::Release를 호출하지 않으면 메모리 누수가 발생합니다.