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

Статья
11/20/2024

Функция 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 (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

SetupDiGetDeviceInstallParams

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