ID2D1RenderTarget::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES&,ID2D1Bitmap**) 메서드(d2d1.h)

아티클
01/10/2024

지정된 WIC(Microsoft Windows 이미징 구성 요소) 비트맵을 복사하여 ID2D1Bitmap 을 만듭니다.

구문

HRESULT CreateBitmapFromWicBitmap(
  IWICBitmapSource               *wicBitmapSource,
  const D2D1_BITMAP_PROPERTIES & bitmapProperties,
  ID2D1Bitmap                    **bitmap
);

매개 변수

wicBitmapSource

형식: [in] IWICBitmapSource*

복사할 WIC 비트맵입니다.

bitmapProperties

형식: [in] const D2D1_BITMAP_PROPERTIES &

만들 비트맵의 픽셀 형식 및 DPI입니다. 픽셀 형식은 wicBitmapSource의 픽셀 형식과 일치해야 합니다. 그렇지 않으면 메서드가 실패합니다. 불일치를 방지하려면 NULL 을 전달하거나 매개 변수 값을 지정하지 않고 D2D1::P ixelFormat 도우미 함수를 호출할 때 얻은 값을 전달할 수 있습니다. dpiX와 dpiY가 모두 0.0f이면 기본 DPI 96이 사용됩니다. wicBitmapSource에 포함된 DPI 정보는 무시됩니다.

bitmap

형식: [out] ID2D1Bitmap**

이 메서드가 반환되면 새 비트맵에 대한 포인터의 주소가 포함됩니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환 값

형식: HRESULT

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

설명

Direct2D가 WIC 비트맵을 로드하려면 먼저 해당 비트맵을 지원되는 픽셀 형식 및 알파 모드로 변환해야 합니다. 지원되는 픽셀 형식 및 알파 모드 목록은 지원되는 픽셀 형식 및 알파 모드를 참조하세요.

예제

예를 들어 파일에서 비트맵을 로드하는 방법 및 리소스에서 비트맵을 로드하는 방법을 참조하세요.

요구 사항


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