ID2D1DeviceContext：：CreateBitmapFromWicBitmap（IWICBitmapSource*，constD2D1_BITMAP_PROPERTIES1*，ID2D1Bitmap1**） 方法 （d2d1_1.h）

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

Syntax

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。 可能的值包括但不限于下表中的值。

注解

从 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 模式。

要求

另请参阅

ID2D1DeviceContext