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 |