ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) 메서드(d2d1.h)

Microsoft WIC(Windows 이미징 구성 요소) 비트맵으로 렌더링되는 렌더링 대상을 만듭니다.

구문

HRESULT CreateWicBitmapRenderTarget(
  [in]  IWICBitmap                            *target,
  [ref] const D2D1_RENDER_TARGET_PROPERTIES & renderTargetProperties,
  [out] ID2D1RenderTarget                     **renderTarget
);

매개 변수

[in] target

형식: IWICBitmap*

렌더링 대상의 렌더링 출력을 수신하는 비트맵입니다.

[ref] renderTargetProperties

형식: const D2D1_RENDER_TARGET_PROPERTIES

렌더링 모드, 픽셀 형식, 원격 옵션, DPI 정보 및 하드웨어 렌더링에 필요한 최소 DirectX 지원입니다. 지원되는 픽셀 형식에 대한 자세한 내용은 지원되는 픽셀 형식 및 알파 모드를 참조하세요.

[out] renderTarget

형식: ID2D1RenderTarget**

이 메서드가 반환되면 이 메서드에서 만든 ID2D1RenderTarget 개체에 대한 포인터의 주소가 포함됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드를 사용하여renderTargetProperties 매개 변수의 minLevel 멤버에 D2D1_FEATURE_LEVEL_DEFAULT 사용해야 합니다.

애플리케이션은 렌더링 대상을 한 번 만들고 애플리케이션의 수명 동안 또는 D2DERR_RECREATE_TARGET 오류가 수신될 때까지 렌더링 대상을 유지해야 합니다. 이 오류가 발생하면 렌더링 대상(및 만든 리소스)을 다시 만들어야 합니다.

참고

이 메서드는 Windows Phone 지원되지 않으며 오류 코드 0x8899000b 있는 디바이스에서 호출될 때 실패합니다("이 작업에 사용할 수 있는 하드웨어 렌더링 디바이스가 없습니다."). Windows Phone 에뮬레이터는 WARP 렌더링을 지원하므로 에뮬레이터에서 다른 오류 코드인 0x88982f80(wincodec_err_unsupportedpixelformat)를 호출하면 이 메서드가 실패합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	d2d1.h
라이브러리	D2d1.lib
DLL	D2d1.dll

추가 정보

ID2D1Factory