ID2D1RenderTarget：：CreateBitmapFromWicBitmap (IWICBitmapSource*，constD2D1_BITMAP_PROPERTIES*，ID2D1Bitmap**) 方法 (d2d1.h)
複製指定的 Microsoft Windows 圖像處理元件 (WIC) 位陣圖，以建立 ID2D1Bitmap 。
語法
HRESULT CreateBitmapFromWicBitmap(
IWICBitmapSource *wicBitmapSource,
const D2D1_BITMAP_PROPERTIES *bitmapProperties,
[out] ID2D1Bitmap **bitmap
);
參數
wicBitmapSource
類型：[in] IWICBitmapSource*
要複製的 WIC 位圖。
bitmapProperties
Type： [in， optional] const D2D1_BITMAP_PROPERTIES*
要建立之位圖的像素格式和 DPI。 圖元格式必須符合 wicBitmapSource 的圖元格式，否則方法將會失敗。 若要避免不符，您可以傳遞 NULL 或傳遞從呼叫 D2D1：:P ixelFormat 協助程式函式取得的值，而不指定任何參數值。 如果 dpiX 和 dpiY 都是 0.0f，則會使用預設 DPI 96。 系統會忽略內嵌在 wicBitmapSource 中的 DPI 資訊。
[out] bitmap
類型： ID2D1Bitmap**
當這個方法傳回時，會包含新位圖指標的位址。 這個參數會以未初始化的狀態傳遞。
傳回值
類型： HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
在 Direct2D 可以載入 WIC 位陣圖之前，該點陣圖必須轉換成支援的圖元格式和 Alpha 模式。 如需支援的圖元格式和 Alpha 模式清單，請參閱 支援的圖元格式和 Alpha 模式。
範例
如需範例，請參閱 如何從檔案載入位圖 和 如何從資源載入位圖。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | d2d1.h |
| 程式庫 | D2d1.lib |
| Dll | D2d1.dll |