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

추가 정보

ID2D1DeviceContext