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

렌더링 대상 표면을 만듭니다.

구문

HRESULT CreateRenderTarget(
  [in]          UINT                Width,
  [in]          UINT                Height,
  [in]          D3DFORMAT           Format,
  [in]          D3DMULTISAMPLE_TYPE MultiSample,
  [in]          DWORD               MultisampleQuality,
  [in]          BOOL                Lockable,
  [out, retval] IDirect3DSurface9   **ppSurface,
  [in]          HANDLE              *pSharedHandle
);

매개 변수

[in] Width

형식: UINT

렌더링 대상 표면의 너비(픽셀)입니다.

[in] Height

형식: UINT

렌더링 대상 표면의 높이(픽셀)입니다.

[in] Format

형식: D3DFORMAT

렌더링 대상의 형식을 설명하는 D3DFORMAT 열거형 형식의 멤버입니다.

[in] MultiSample

형식: D3DMULTISAMPLE_TYPE

다중 샘플링 버퍼 형식을 설명하는 D3DMULTISAMPLE_TYPE 열거형 형식의 멤버입니다. 이 매개 변수는 이 렌더링 대상에 대한 앤티앨리어싱 형식을 지정합니다. 이 표면이 IDirect3DDevice9::SetRenderTarget에 전달되면 해당 멀티샘플 형식은 IDirect3DDevice9::SetDepthStencilSurface에서 설정한 깊이 스텐실 형식과 동일해야 합니다.

[in] MultisampleQuality

형식: DWORD

품질 수준. 유효한 범위는 IDirect3D9::CheckDeviceMultiSampleType에서 사용하는 pQualityLevels에서 반환하는 수준보다 0에서 1 사이입니다. 더 큰 값을 전달하면 D3DERR_INVALIDCALL 오류가 반환됩니다. 쌍을 이루는 렌더링 대상, 깊이 스텐실 표면 및 다중 샘플 형식의 MultisampleQuality 값이 모두 일치해야 합니다.

[in] Lockable

형식: BOOL

애플리케이션이 Lockable에 대해 TRUE 를 지정하지 않으면 렌더링 대상을 잠글 수 없습니다.

잠금 가능한 렌더링 대상은 일부 그래픽 하드웨어의 성능을 감소시킵니다. 읽기 저장 성능(비디오 메모리에서 시스템 메모리로 데이터 이동)은 사용되는 하드웨어 유형(AGP 및 PCI Express)에 따라 달라지며 일반적으로 업로드 성능(시스템에서 비디오 메모리로 데이터 이동)보다 훨씬 낮습니다. 렌더링 대상에 대한 읽기 권한이 필요한 경우 잠금 가능한 렌더링 대상 대신 GetRenderTargetData 를 사용합니다.

[out, retval] ppSurface

형식: IDirect3DSurface9**

IDirect3DSurface9 인터페이스에 대한 포인터의 주소입니다.

[in] pSharedHandle

형식: HANDLE*

예약되어 있습니다. 이 매개 변수를 NULL로 설정합니다. 이 매개 변수는 Windows Vista용 Direct3D 9에서 리소스를 공유하는 데 사용할 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_NOTAVAILABLE, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY 중 하나일 수 있습니다.

설명

렌더링 대상 표면은 D3DPOOL_DEFAULT 메모리 클래스에 배치됩니다.

잠금 가능한 다중 샘플링된 렌더링 대상 만들기는 지원되지 않습니다.

요구 사항

대상 플랫폼	Windows
헤더	d3d9helper.h(D3D9.h 포함)
라이브러리	D3D9.lib

추가 정보

IDirect3DDevice9