wingdi.h) (DISPLAYCONFIG_PATH_SOURCE_INFO 结构

DISPLAYCONFIG_PATH_SOURCE_INFO 结构包含单个路径的源信息。

语法

typedef struct DISPLAYCONFIG_PATH_SOURCE_INFO {
  LUID   adapterId;
  UINT32 id;
  union {
    UINT32 modeInfoIdx;
    struct {
      UINT32 cloneGroupId : 16;
      UINT32 sourceModeInfoIdx : 16;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  UINT32 statusFlags;
} DISPLAYCONFIG_PATH_SOURCE_INFO;

成员

adapterId

此源信息与之相关的适配器的标识符。

id

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

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

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

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.cloneGroupId

一个有效标识符,用于显示仅当设置了DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE时路径是其成员的克隆组。 如果此值无效,则必须将其设置为DISPLAYCONFIG_PATH_CLONE_GROUP_INVALID。

cloneGroupId 仅在未指定源模式索引时使用。 其中两种情况是,源模式信息必须无效,因为使用了SDC_TOPOLOGY_SUPPLIED,而SDC_USE_SUPPLIED_DISPLAY_CONFIG与没有源模式信息的路径一起使用。 cloneGroupId 将用于指示克隆组中的路径,具有相同 cloneGroupId 值的所有路径都被视为在同一克隆组中。 克隆组 ID 不要求必须从零开始或连续。 从 Windows 10 开始支持。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.sourceModeInfoIdx

DISPLAYCONFIG_SOURCE_MODE 条目的 模式数组的有效索引,该索引仅在设置DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE时才包含此路径的源模式信息。 如果模式数组中没有此项的条目,则 sourceModeInfoIdx 的值DISPLAYCONFIG_PATH_SOURCE_MODE_IDX_INVALID。 从 Windows 10 开始支持。

statusFlags

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

DISPLAYCONFIG_SOURCE_IN_USE

此源由至少一个活动路径使用。

注解

DISPLAYCONFIG_PATH_SOURCE_INFO 结构在 DISPLAYCONFIG_PATH_INFO 结构的 sourceInfo 成员中指定。

源对应于显示适配器可在其上呈现像素的图面。 每个显示适配器都能够呈现为 x 个源。 这意味着在扩展模式下可以呈现多少个桌面。 这通常为 2。 例如,源 0 可能是从 0,0 到 1024,768 的呈现像素,而源 1 可能是从 1025,0 到 2048、768 的呈现像素。

要求

要求
最低受支持的客户端 在 Windows 7 客户端中可用。
标头 wingdi.h (包括 Windows.h)

另请参阅

DISPLAYCONFIG_PATH_INFO