структура DISPLAYCONFIG_PATH_TARGET_INFO (wingdi.h)

Статья
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_TARGET_MODE , который содержит сведения о целевом режиме для этого пути, только если задан DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE. Если в массиве режима нет записи для этого, значение targetModeInfoIdx будет DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID. Поддерживается начиная с Windows 10.

outputTechnology

Тип соединителя целевого объекта. Список возможных значений см . в DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY перечислимом типе.

rotation

Значение типа , указывающее поворот целевого объекта. Список возможных значений см . в DISPLAYCONFIG_ROTATION перечислимом типе.

scaling

Значение типа , указывающее, как исходный образ масштабируется до целевого объекта. Список возможных значений см . в DISPLAYCONFIG_SCALING перечислимом типе. Дополнительные сведения о масштабировании см. в статье Масштабирование образа рабочего стола.

refreshRate

Структура DISPLAYCONFIG_RATIONAL , указывающая частоту обновления целевого объекта. Если вызывающий объект указывает сведения о целевом режиме, операционная система будет использовать частоту обновления, которая хранится в элементе vSyncFreqструктуры DISPLAYCONFIG_VIDEO_SIGNAL_INFO . В этом случае вызывающий объект задает это значение в элементе targetVideoSignalInfoструктуры DISPLAYCONFIG_TARGET_MODE . Частота обновления с числителем и знаменателем, равными нулю, означает, что вызывающий объект не задает частоту обновления и операционная система должна использовать наиболее оптимальную доступную частоту обновления. В этом случае при вызове функции SetDisplayConfig вызывающий объект должен задать для члена scanLineOrdering значение DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED; В противном случае SetDisplayConfig завершается сбоем.

scanLineOrdering

Значение типа , указывающее порядок строк сканирования выходных данных на целевом объекте. Список возможных значений см . в DISPLAYCONFIG_SCANLINE_ORDERING перечислимом типе. Если вызывающий объект указывает сведения о целевом режиме, операционная система будет использовать упорядочение строк сканирования, хранящееся в элементе scanLineOrderingструктуры DISPLAYCONFIG_VIDEO_SIGNAL_INFO . В этом случае вызывающий объект задает это значение в элементе targetVideoSignalInfoструктуры DISPLAYCONFIG_TARGET_MODE .

targetAvailable

Логическое значение, указывающее, доступен ли целевой объект. Значение TRUE указывает, что целевой объект доступен.

Так как асинхронная природа топологии отображения изменяется при удалении монитора, путь может по-прежнему помечаться как активный, даже если монитор был удален. В этом случае параметр targetAvailable может иметь значение FALSE для активного пути. Обычно это временная ситуация, которая изменится после того, как операционная система примет меры по удалению монитора.

statusFlags

Побитовое ИЛИ значений флага, указывающее состояние целевого объекта. Поддерживаются следующие значения.

Значение	Значение
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). Такой путь возвращается только из QueryDisplayConfig с помощью флага QDC_INCLUDE_HMD. Поддерживается начиная с Windows 10 Creators Update (версия 1703).

Целевой объект соответствует количеству возможных видеовыходов на видеоадаптере. Однако это число не соответствует количеству физических соединителей на адаптере дисплея. Каждый соединитель предоставляет ряд целевых объектов, включая обратную совместимость с более старой технологией соединителя. Например, соединитель DVI предоставляет целевой объект DVI, а также целевой объект VGA. Соединитель DisplayPort, который был представлен в 2006 году, предоставляет целевые объекты DisplayPort, HDMI, DVI, устаревшие телевизоры и VGA.

Элемент statusFlags задается при вызове функции QueryDisplayConfig .

Требования

Требование	Значение
Минимальная версия клиента	Доступно в клиенте Windows 7.
Верхняя часть	wingdi.h (включая Windows.h)