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 |