wingdi.h) (DISPLAYCONFIG_PATH_TARGET_INFO 结构

项目
08/27/2023

DISPLAYCONFIG_PATH_TARGET_INFO 结构包含单个路径的目标信息。

语法

typedef struct DISPLAYCONFIG_PATH_TARGET_INFO {
  LUID                                  adapterId;
  UINT32                                id;
  union {
    UINT32 modeInfoIdx;
    struct {
      UINT32 desktopModeInfoIdx : 16;
      UINT32 targetModeInfoIdx : 16;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY outputTechnology;
  DISPLAYCONFIG_ROTATION                rotation;
  DISPLAYCONFIG_SCALING                 scaling;
  DISPLAYCONFIG_RATIONAL                refreshRate;
  DISPLAYCONFIG_SCANLINE_ORDERING       scanLineOrdering;
  BOOL                                  targetAvailable;
  UINT32                                statusFlags;
} DISPLAYCONFIG_PATH_TARGET_INFO;

成员

adapterId

路径位于的适配器的标识符。

id

此路径所关联的指定适配器上的目标标识符。

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

仅在未设置DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE时才包含此路径的目标模式信息的模式信息表中的有效索引。如果目标模式信息不可用，则 modeInfoIdx 的值DISPLAYCONFIG_PATH_MODE_IDX_INVALID。

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx

DISPLAYCONFIG_DESKTOP_IMAGE_INFO 条目的模式数组的有效索引，该条目仅在设置DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE时才包含此路径的桌面模式信息。如果模式数组中没有此项条目，则 desktopModeInfoIdx 的值DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID。从 Windows 10 开始支持。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx

仅当设置了DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE时，才包含此路径的目标模式信息的 DISPLAYCONFIG_TARGET_MODE 条目的模式数组的有效索引。如果模式数组中没有此项的条目，则 targetModeInfoIdx 的值DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID。从 Windows 10 开始支持。

outputTechnology

目标的连接器类型。有关可能值的列表，请参阅 DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY 枚举类型。

rotation

一个值，该值指定目标的旋转。有关可能值的列表，请参阅 DISPLAYCONFIG_ROTATION 枚举类型。

scaling

一个值，该值指定如何将源图像缩放到目标。有关可能值的列表，请参阅 DISPLAYCONFIG_SCALING 枚举类型。有关缩放的详细信息，请参阅缩放桌面映像。

refreshRate

一个DISPLAYCONFIG_RATIONAL结构，用于指定目标的刷新率。如果调用方指定目标模式信息，则操作系统将改用存储在 DISPLAYCONFIG_VIDEO_SIGNAL_INFO 结构的 vSyncFreq 成员中的刷新率。在这种情况下，调用方在 DISPLAYCONFIG_TARGET_MODE 结构的 targetVideoSignalInfo 成员中指定此值。如果将分子和分母设置为零的刷新速率，则表明调用方未指定刷新速率，操作系统应使用可用的最佳刷新速率。在这种情况下，在调用 SetDisplayConfig 函数时，调用方必须将 scanLineOrdering 成员设置为DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED值;否则， SetDisplayConfig 将失败。

scanLineOrdering

一个值，该值指定目标上输出的扫描行顺序。有关可能值的列表，请参阅 DISPLAYCONFIG_SCANLINE_ORDERING 枚举类型。如果调用方指定目标模式信息，则操作系统将改用存储在DISPLAYCONFIG_VIDEO_SIGNAL_INFO结构的 scanLineOrdering 成员中的扫描行排序。在这种情况下，调用方在 DISPLAYCONFIG_TARGET_MODE 结构的 targetVideoSignalInfo 成员中指定此值。

targetAvailable

一个布尔值，指定目标是否可用。 TRUE 指示目标可用。

由于删除监视器时显示拓扑的异步性质会发生变化，因此即使删除了监视器，路径仍可能标记为活动。在这种情况下，对于活动路径， targetAvailable 可以为 FALSE 。这通常是暂时性的情况，在操作系统对监视器删除执行操作后会发生变化。

statusFlags

指示目标状态的标志值的按位 OR。支持以下值：

值	含义
DISPLAYCONFIG_TARGET_IN_USE 0x00000001	目标在活动路径上使用。
DISPLAYCONFIG_TARGET_FORCIBLE 0x00000002	即使未检测到监视器，也可以强制对此目标执行输出。
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT 0x00000004	当前正以持续启动方式强制输出。
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH 0x00000008	当前正以路径持久性方式强制输出。
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM 0x00000010	当前以非持久性方式强制输出。
DISPLAYCONFIG_TARGET_IS_HMD 0x00000020	输出是头戴式显示器 (HMD) 。此类路径仅使用 QDC_INCLUDE_HMD 标志从 QueryDisplayConfig 返回。从 Windows 10 创意者更新 (版本 1703) 开始受支持。

注解

DISPLAYCONFIG_PATH_TARGET_INFO 结构在 DISPLAYCONFIG_PATH_INFO 结构的 targetInfo 成员中指定。

目标对应于显示适配器上可能的视频输出数。但是，此数字并不等同于显示适配器上的物理连接器数。每个连接器都公开许多目标，其中包括与旧连接器技术的向后兼容性。例如，DVI 连接器公开 DVI 目标和 VGA 目标。 2006 年引入的 DisplayPort 连接器公开 DisplayPort、HDMI、DVI、旧式电视和 VGA 目标。

调用 QueryDisplayConfig 函数时，将设置 statusFlags 成员。