Функция DisplayConfigGetDeviceInfo (winuser.h)

Статья
08/27/2023

Функция DisplayConfigGetDeviceInfo извлекает сведения о конфигурации отображения устройства.

Синтаксис

LONG DisplayConfigGetDeviceInfo(
  [in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);

Параметры

[in, out] requestPacket

Указатель на структуру DISPLAYCONFIG_DEVICE_INFO_HEADER . Эта структура содержит сведения о запросе, который включает тип пакета в члене типа . Тип и размер дополнительных данных, возвращаемых DisplayConfigGetDeviceInfo после структуры заголовка, зависят от типа пакета.

Возвращаемое значение

Функция возвращает один из следующих кодов возврата.

Код возврата	Описание
ERROR_SUCCESS	Функция выполнена успешно.
ERROR_INVALID_PARAMETER	Сочетание указанных параметров и флагов недопустимо.
ERROR_NOT_SUPPORTED	В системе не запущен графический драйвер, написанный в соответствии с моделью драйвера дисплея Windows (WDDM). Функция поддерживается только в системе с работающим драйвером WDDM.
ERROR_ACCESS_DENIED	Вызывающий объект не имеет доступа к сеансу консоли. Эта ошибка возникает, если вызывающий процесс не имеет доступа к текущему рабочему столу или выполняется в удаленном сеансе.
ERROR_INSUFFICIENT_BUFFER	Размер пакета, который передает вызывающий объект, недостаточно велик для информации, которую запрашивает вызывающий объект.
ERROR_GEN_FAILURE	Произошла неизвестная ошибка.

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

Вызывающий объект может вызвать DisplayConfigGetDeviceInfo , чтобы получить более понятные имена для отображения в пользовательском интерфейсе. Вызывающий объект может получить имена адаптера, источника и целевого объекта. Вызывающий объект также может вызвать DisplayConfigGetDeviceInfo , чтобы получить наилучшее разрешение подключенного устройства отображения.

Примеры

Пример DisplayConfigGetDeviceInfo см. в разделе QueryDisplayConfig.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	winuser.h (включая Windows.h)
Библиотека	User32.lib; OneCoreUAP.lib в Windows 10
DLL	User32.dll
Набор API	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (представлено в Windows 10 версии 10.0.14393)

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

DISPLAYCONFIG_DEVICE_INFO_HEADER

DISPLAYCONFIG_TARGET_DEVICE_NAME

DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS

DisplayConfigSetDeviceInfo

Поделиться через