Share via

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

  • Статья

Функция DisplayConfigSetDeviceInfo задает свойства целевого объекта.

Синтаксис

LONG DisplayConfigSetDeviceInfo(
  [in] DISPLAYCONFIG_DEVICE_INFO_HEADER *setPacket
);

Параметры

[in] setPacket

Указатель на структуру DISPLAYCONFIG_DEVICE_INFO_HEADER , содержащую сведения, заданные для устройства. Тип и размер дополнительных данных, которые DisplayConfigSetDeviceInfo использует для конфигурации, поступают после структуры заголовка. Эти дополнительные данные зависят от типа пакета, указанного членом типа DISPLAYCONFIG_DEVICE_INFO_HEADER. Например, если вызывающий объект хочет изменить сохраняемость загрузки, вызывающий объект выделяет и заполняет структуру DISPLAYCONFIG_SET_TARGET_PERSISTENCE и передает указатель на эту структуру в setPacket. Обратите внимание, что первым элементом структуры DISPLAYCONFIG_SET_TARGET_PERSISTENCE является DISPLAYCONFIG_DEVICE_INFO_HEADER.

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

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

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

Комментарии

DisplayConfigSetDeviceInfo в настоящее время можно использовать только для запуска и остановки проекции сохраняемой силы загрузки на аналоговый целевой объект. Дополнительные сведения о сохраняемости загрузки см. в разделе Принудительные и подключенные целевые объекты.

DisplayConfigSetDeviceInfo можно использовать только для задания DISPLAYCONFIG_DEVICE_INFO_SET_XXX типа информации. DisplayConfigSetDeviceInfo завершается ошибкой , если для элемента типаDISPLAYCONFIG_DEVICE_INFO_HEADER задано одно из DISPLAYCONFIG_DEVICE_INFO_GET_XXX значений.

Требования

Требование Значение
Минимальная версия клиента Доступно в 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

DisplayConfigGetDeviceInfo