通过

RenderTargetProperties 函数 (d2d1helper.h)

  • 项目

创建 D2D1_RENDER_TARGET_PROPERTIES 结构。

语法

D2D1_RENDER_TARGET_PROPERTIES RenderTargetProperties(
       D2D1_RENDER_TARGET_TYPE   type,
  [in] const D2D1_PIXEL_FORMAT & pixelFormat,
       FLOAT                     dpiX,
       FLOAT                     dpiY,
       D2D1_RENDER_TARGET_USAGE  usage,
       D2D1_FEATURE_LEVEL        minLevel
);

参数

type

类型： D2D1_RENDER_TARGET_TYPE

一个 值，该值指定呈现目标是必须使用硬件呈现还是软件呈现。 默认值 D2D1_RENDER_TARGET_TYPE_DEFAULT指定使用硬件呈现;如果硬件呈现不可用，则呈现目标使用软件呈现。 请注意，WIC 位图呈现目标不支持硬件呈现。

[in] pixelFormat

类型： const D2D1_PIXEL_FORMAT

呈现目标的像素格式和 alpha 模式。 默认像素格式为 D2D1：:P ixelFormat，告知 Direct2D 选择呈现目标支持的像素格式。 有关每个呈现目标支持的像素格式和 alpha 模式的列表，请参阅 支持的像素格式和 Alpha 模式。

dpiX

类型： FLOAT

呈现目标的水平 DPI。 默认值为 0.0。 如果 dpiX 和 dpiY 都设置为 0.0，则呈现目标将使用其默认 DPI。 有关详细信息，请参阅 D2D1_RENDER_TARGET_PROPERTIES。

dpiY

类型： FLOAT

呈现目标的垂直 DPI。 默认值为 0.0。 如果 dpiX 和 dpiY 都设置为 0.0，则呈现目标将使用其默认 DPI。 有关详细信息，请参阅 D2D1_RENDER_TARGET_PROPERTIES。

usage

类型： D2D1_RENDER_TARGET_USAGE

指定如何远程呈现呈现目标，以及它是否应与 GDI 兼容。 默认值 （D2D1_RENDER_TARGET_USAGE_NONE）创建与 GDI 不兼容并使用 Direct3D 命令流远程渲染（如果可用）的呈现目标。

minLevel

类型： D2D1_FEATURE_LEVEL

硬件呈现所需的最低 Direct3D 功能级别。 默认值 D2D1_FEATURE_LEVEL_DEFAULT指示 Direct2D 应确定设备的 Direct3D 功能级别是否足够。 仅当创建 ID2D1HwndRenderTarget 和 ID2D1DCRenderTarget 对象时，才使用此字段。 有关详细信息，请参阅 D2D1_RENDER_TARGET_PROPERTIES。

返回值

类型： D2D1_RENDER_TARGET_PROPERTIES

包含指定设置 的D2D1_RENDER_TARGET_PROPERTIES 。

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1helper.h
Library D2d1.lib
DLL D2d1.dll

另请参阅

D2D1_RENDER_TARGET_PROPERTIES结构

支持的像素格式和 Alpha 模式