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_PREMULTIPLIEDD2D1_ALPHA_MODE_STRAIGHTD2D1_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