Share via

ID2D1RenderTarget：：CreateCompatibleRenderTarget (D2D1_SIZE_F，D2D1_SIZE_U，ID2D1BitmapRenderTarget**) 方法 (d2d1.h)

  • 项目

创建与当前呈现目标兼容的中间屏幕外绘制期间使用的位图呈现目标。

语法

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

参数

desiredSize

类型：[in] D2D1_SIZE_F

新呈现目标的所需大小 (与设备无关的像素) （如果它应与原始呈现目标不同）。 有关详细信息，请参阅“备注”部分。

desiredPixelSize

类型：[in] D2D1_SIZE_U

如果新呈现目标应与原始呈现目标不同，则为所需大小（以像素为单位）。 有关详细信息，请参见“备注”部分。

bitmapRenderTarget

类型：[out] ID2D1BitmapRenderTarget**

此方法返回时，包含指向指向新位图呈现目标的指针的指针。 此参数未经初始化即被传递。

返回值

类型： HRESULT

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

注解

可以通过指定 desiredSize 或 desiredPixelSize 的值来更改新呈现目标的像素大小和 DPI。

  • 如果指定 了 desiredSize ，但 未指定 desiredPixelSize ，则使用父目标 DPI 根据所需大小计算像素大小。 如果 desiredSize 映射到整数像素大小，则兼容呈现目标的 DPI 与父目标的 DPI 相同。 如果 desiredSize 映射到小数像素大小，则像素大小向上舍入为最接近的整数，并且兼容呈现目标的 DPI 略高于父呈现目标的 DPI。 在所有情况下，坐标 (desiredSize.width、 desiredSize.height) 映射到兼容呈现目标的右下角。
  • 如果指定了 desiredPixelSize ，而 desiredSize 未指定，则新呈现目标的 DPI 与原始呈现目标相同。
  • 如果同时指定 了 desiredSize 和 desiredPixelSize ，则会计算新呈现目标的 DPI 以考虑比例差异。
  • 如果未指定 desiredSize 和 desiredPixelSize ，则新的呈现目标大小和 DPI 与原始呈现目标匹配。

此方法创建的位图呈现目标与 GDI 不兼容。

要求

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

另请参阅

ID2D1RenderTarget