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

另請參閱

如何從檔案載入點陣圖

ID2D1Bitmap

ID2D1RenderTarget

支援的像素格式和 Alpha 模式