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

Функция SetupDiSetDeviceInstallParamsA (setupapi.h)

  • Статья

Функция SetupDiSetDeviceInstallParams задает параметры установки устройства для набора сведений об устройстве или определенного элемента сведений об устройстве.

Синтаксис

WINSETUPAPI BOOL SetupDiSetDeviceInstallParamsA(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [in]           PSP_DEVINSTALL_PARAMS_A DeviceInstallParams
);

Параметры

[in] DeviceInfoSet

Дескриптор набора сведений об устройстве , для которого необходимо задать параметры установки устройства.

[in, optional] DeviceInfoData

Указатель на структуру SP_DEVINFO_DATA , указывающую элемент сведений об устройстве в DeviceInfoSet. Этот параметр является необязательным и может иметь значение NULL. Если указан этот параметр, SetupDiSetDeviceInstallParams задает параметры установки для указанного устройства. Если этот параметр имеет значение NULL, SetupDiSetDeviceInstallParams задает параметры установки, связанные со списком драйверов глобального класса для DeviceInfoSet.

[in] DeviceInstallParams

Указатель на структуру SP_DEVINSTALL_PARAMS , содержащую новые значения параметров. DeviceInstallParams.Перед вызовом этой функции cbSize необходимо задать размер структуры в байтах.

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

Функция возвращает ЗНАЧЕНИЕ TRUE , если оно выполнено успешно. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError.

Комментарии

Все параметры проверяются перед внесением изменений. Таким образом, возвращаемое значение FALSE указывает, что параметры не были изменены.

Примечание

Заголовок setupapi.h определяет SetupDiSetDeviceInstallParams в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть setupapi.h (включая Setupapi.h)
Библиотека Setupapi.lib

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

SetupDiGetDeviceInstallParams