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

类型：[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 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1.h
Library D2d1.lib
DLL D2d1.dll

另请参阅

如何从文件加载位图

ID2D1Bitmap

ID2D1RenderTarget

支持的像素格式和 Alpha 模式