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 |