Share via

ID2D1DeviceContext：：CreateBitmapFromWicBitmap (IWICBitmapSource*，constD2D1_BITMAP_PROPERTIES1*，ID2D1Bitmap1**) 方法 (d2d1_1.h)

  • 项目

通过复制 WIC 位图创建 Direct2D 位图。

语法

HRESULT CreateBitmapFromWicBitmap(
  [in]           IWICBitmapSource              *wicBitmapSource,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

参数

[in] wicBitmapSource

类型： IWICBitmapSource*

要从中复制的 WIC 位图源。

[in, optional] bitmapProperties

类型： const D2D1_BITMAP_PROPERTIES1*

指定位图创建选项的位图属性结构。

[out] bitmap

类型： ID2D1Bitmap1**

新创建的位图对象的地址。

返回值

类型： HRESULT

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

HRESULT 说明
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 模式。

要求

要求 值
最低受支持的客户端 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1_1.h
DLL D2d1.dll

另请参阅

ID2D1DeviceContext