WIC 비트맵을 복사하여 Direct2D 비트맵을 만듭니다.
문법
HRESULT CreateBitmapFromWicBitmap(
[in] IWICBitmapSource *wicBitmapSource,
[in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
[out] ID2D1Bitmap1 **bitmap
);
매개 변수
[in] wicBitmapSource
형식: IWICBitmapSource*
복사할 WIC 비트맵 원본입니다.
[in, optional] bitmapProperties
형식: const D2D1_BITMAP_PROPERTIES1*
비트맵 만들기 옵션을 지정하는 비트맵 속성 구조체입니다.
[out] bitmap
형식: ID2D1Bitmap1**
새로 만든 비트맵 개체의 주소입니다.
반환 값
형식: HRESULT
이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 제한되지는 않습니다.
| HRESULT | Description |
|---|---|
| S_OK | 오류가 발생하지 않았습니다. |
| E_OUTOFMEMORY | Direct2D에서 호출을 완료하기에 충분한 메모리를 할당할 수 없습니다. |
| E_INVALIDARG | 잘못된 매개 변수가 반환 함수에 전달되었습니다. |
비고
Windows 8.1부터 bitmapProperties 매개 변수는 선택 사항입니다. 지정하지 않으면 생성된 비트맵은 wicBitmapSource에서 픽셀 형식 및 알파 모드를 상속합니다. 지원되는 픽셀 형식 및 알파 모드 목록은 지원되는 픽셀 형식 및 알파 모드를 참조하세요.
bitmapProperties 매개 변수를 지정하면 bitmapProperties-pixelFormat>의 값이 DXGI_FORMAT_UNKNOWN 되거나 wicBitmapSource의 WIC 픽셀 형식과 일치해야 합니다.
bitmapProperties-pixelFormat.alphaMode>가 D2D1_ALPHA_MODE_UNKNOWN 설정되면 새로 만든 비트맵은 wicBitmapSource에서 알파 모드를 상속합니다. bitmapProperties-pixelFormat.alphaMode>를 D2D1_ALPHA_MODE_PREMULTIPLIED, D2D1_ALPHA_MODE_STRAIGHT 또는 D2D1_ALPHA_MODE_IGNORE 설정하면 새로 만든 비트맵이 지정된 알파 모드를 사용하도록 강제 적용됩니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2012 및 Windows Server 2008 R2용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | 윈도우즈 |
| Header | d2d1_1.h |
| DLL | D2d1.dll |