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。 可能的值包括 (但不限於) 下表中的這些值。

備註

從 Windows 8.1 開始，bitmapProperties 參數是選擇性的。 未指定時，所建立的位圖會從 wicBitmapSource 繼承圖元格式和 Alpha 模式。 如需支援的圖元格式和 Alpha 模式清單，請參閱 支援的圖元格式和 Alpha 模式。

指定 bitmapProperties 參數時，bitmapProperties-pixelFormat> 中的值必須DXGI_FORMAT_UNKNOWN，或必須符合 wicBitmapSource 中的 WIC 像素格式。

當 bitmapProperties-pixelFormat.alphaMode> 設定為 D2D1_ALPHA_MODE_UNKNOWN 時，新建立的位圖會從 wicBitmapSource 繼承 Alpha 模式。 當 bitmapProperties-pixelFormat.alphaMode> 設定為 D2D1_ALPHA_MODE_PREMULTIPLIED、D2D1_ALPHA_MODE_STRAIGHT或D2D1_ALPHA_MODE_IGNORE時，這會強制新建立的位圖使用指定的 Alpha 模式。

規格需求

另請參閱

ID2D1DeviceContext