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

Статья
11/20/2024

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

Синтаксис

WINSETUPAPI BOOL SetupDiSetDriverInstallParamsA(
  [in]           HDEVINFO              DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA      DeviceInfoData,
  [in]           PSP_DRVINFO_DATA_A    DriverInfoData,
  [in]           PSP_DRVINSTALL_PARAMS DriverInstallParams
);

Параметры

[in] DeviceInfoSet

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

[in, optional] DeviceInfoData

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

[in] DriverInfoData

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

[in] DriverInstallParams

Указатель на структуру SP_DRVINSTALL_PARAMS, указывающую новые параметры установки драйвера.

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

Функция возвращает TRUE, если она выполнена успешно. В противном случае возвращается FALSE и ошибка журнала может быть получена вызовом GetLastError.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	setupapi.h (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

SetupDiGetDriverInstallParams

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