ID2D1Factory::CreateWicBitmapRenderTarget (IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) 方法 (d2d1.h)

创建一个呈现目标,该目标 (WIC) 位图呈现到 Microsoft Windows 图像处理组件。

语法

HRESULT CreateWicBitmapRenderTarget(
  [in]  IWICBitmap                            *target,
  [ref] const D2D1_RENDER_TARGET_PROPERTIES & renderTargetProperties,
  [out] ID2D1RenderTarget                     **renderTarget
);

参数

[in] target

类型: IWICBitmap*

接收呈现目标的呈现输出的位图。

[ref] renderTargetProperties

类型: const D2D1_RENDER_TARGET_PROPERTIES

呈现模式、像素格式、远程处理选项、DPI 信息和硬件呈现所需的最低 DirectX 支持。 有关支持的像素格式的信息,请参阅 支持的像素格式和 Alpha 模式

[out] renderTarget

类型: ID2D1RenderTarget**

此方法返回时,包含指向此方法创建的 ID2D1RenderTarget 对象的指针的地址。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

注解

必须使用此方法对 renderTargetProperties 参数的 minLevel 成员使用 D2D1_FEATURE_LEVEL_DEFAULT

应用程序应创建一次呈现目标,并在应用程序的生命周期内保留这些目标,直到收到 D2DERR_RECREATE_TARGET 错误。 收到此错误时,需要重新创建呈现目标 (以及它创建的任何资源) 。

注意

此方法在 Windows Phone 上不受支持,在出现错误代码0x8899000b (“没有可用于此操作的硬件呈现设备”) 的设备上调用此方法时会失败。 由于 Windows Phone 仿真器支持 WARP 呈现,因此在模拟器上调用此方法时会失败,并显示不同的错误代码,0x88982f80 (wincodec_err_unsupportedpixelformat) 。

要求

要求
最低受支持的客户端 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

另请参阅

ID2D1Factory