ID2D1DeviceContext::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) 메서드(d2d1_1.h)
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 | 설명 |
|---|---|
| S_OK | 오류가 발생하지 않았습니다. |
| E_OUTOFMEMORY | Direct2D에서 호출을 완료하는 데 충분한 메모리를 할당할 수 없습니다. |
| E_INVALIDARG | 잘못된 매개 변수가 반환 함수에 전달되었습니다. |
설명
Windows 8.1 비트맵속성 매개 변수는 선택 사항입니다. 지정하지 않으면 생성된 비트맵은 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 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | d2d1_1.h |
| DLL | D2d1.dll |