透過複製 WIC 位圖來建立 Direct2D 位圖。
語法
HRESULT CreateBitmapFromWicBitmap(
[in] IWICBitmapSource *wicBitmapSource,
[in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
[out] ID2D1Bitmap1 **bitmap
);
參數
[in] wicBitmapSource
類型： IWICBitmapSource*
WIC點陣圖來源，要複製。
[in, optional] bitmapProperties
類型： 連續 D2D1_BITMAP_PROPERTIES1*
一個位圖屬性結構，用來指定點陣建立選項。
[out] bitmap
類型： ID2D1Bitmap1**
新建立的點陣圖物件的位址。
返回值
類型：HRESULT
這個方法會傳回 HRESULT。 可能的值包括但不限於下表中的值。
| HRESULT | Description |
|---|---|
| S_OK | 未發生任何錯誤。 |
| E_OUTOFMEMORY | Direct2D 無法配置足夠的記憶體來完成呼叫。 |
| E_INVALIDARG | 一個無效參數被傳給回傳函數。 |
備註
從 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 模式。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 8 和 Windows 7 的平台更新 [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows Server 2012 和 Windows Server 2008 R2 的平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| Header | d2d1_1.h |
| DLL | D2d1.dll |