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

Структура DISPLAYCONFIG_TARGET_DEVICE_NAME содержит сведения о целевом объекте.

Синтаксис

typedef struct DISPLAYCONFIG_TARGET_DEVICE_NAME {
  DISPLAYCONFIG_DEVICE_INFO_HEADER       header;
  DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS flags;
  DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY  outputTechnology;
  UINT16                                 edidManufactureId;
  UINT16                                 edidProductCodeId;
  UINT32                                 connectorInstance;
  WCHAR                                  monitorFriendlyDeviceName[64];
  WCHAR                                  monitorDevicePath[128];
} DISPLAYCONFIG_TARGET_DEVICE_NAME;

Члены

header

Структура DISPLAYCONFIG_DEVICE_INFO_HEADER , содержащая сведения о запросе имени целевого устройства. Вызывающий объект должен задать для элемента типа DISPLAYCONFIG_DEVICE_INFO_HEADER значение DISPLAYCONFIG_DEVICE_INFO_GET_TARGET_NAME, а элементы adapterId и id DISPLAYCONFIG_DEVICE_INFO_HEADER целевому объекту, для которого вызывающему объекту требуется имя целевого устройства. Вызывающий объект должен задать размер элемента DISPLAYCONFIG_DEVICE_INFO_HEADER как минимум размер структуры DISPLAYCONFIG_TARGET_DEVICE_NAME.

flags

Структура DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS , определяющая в флагах битовых полей сведения о целевом объекте.

outputTechnology

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

edidManufactureId

Идентификатор производства из расширенных идентификационных данных монитора (EDID). Этот элемент задается только в том случае, если битовое поле edidIdsValid задано в элементе flags .

edidProductCodeId

Код продукта из монитора EDID. Этот элемент задается только в том случае, если битовое поле edidIdsValid задано в элементе flags .

connectorInstance

Номер экземпляра этого конкретного целевого объекта только в том случае, если адаптер имеет несколько целевых объектов этого типа. Экземпляр соединителя — это последовательный одноуровневый номер, уникальный в пределах каждого адаптера. Если это единственный целевой объект этого типа на адаптере, это значение равно нулю.

monitorFriendlyDeviceName[64]

Строка WCHAR с завершением NULL, которая является именем устройства для монитора. Это имя можно использовать с SetupAPI.dll для получения имени устройства, содержащегося в пакете установки.

monitorDevicePath[128]

Строка WCHAR, завершающаяся null, которая является путем к имени устройства для монитора. Этот путь можно использовать с SetupAPI.dll для получения имени устройства, содержащегося в пакете установки.

Комментарии

Расширенные данные идентификации дисплея (EDID) — это набор данных, предоставляемых дисплеем для описания его возможностей графического адаптера. Данные EDID позволяют компьютеру определять тип монитора, подключенного к нему. Данные EDID включают имя производителя, тип продукта, время, поддерживаемую дисплеем, размер дисплея, а также другие характеристики дисплея. EDID определяется стандартом, опубликованным Ассоциацией стандартов видеоэлектроники (VESA).

Именованный объект устройства имеет путь и имя в формате \Device\DeviceName. Это называется именем объекта устройства.

Если приложение вызывает функцию DisplayConfigGetDeviceInfo для получения имени монитора, а DisplayConfigGetDeviceInfo либо не может получить имя монитора, либо целевой объект принудительно используется без подключенного монитора, строка в элементе monitorFriendlyDeviceName структуры DISPLAYCONFIG_TARGET_DEVICE_NAME является строкой NULL и ни один из флагов битовых полей в структуре DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS не задан.

Требования

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

См. также раздел

DISPLAYCONFIG_DEVICE_INFO_HEADER

DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS

DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY

DisplayConfigGetDeviceInfo