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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] DeviceInfoSet

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

[in, optional] DeviceInfoData

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

[in] DriverInfoData

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

[out] DriverInstallParams

Указатель на структуру SP_DRVINSTALL_PARAMS для получения параметров установки для этого драйвера.

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

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

Замечания

Заметка

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

Требования

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

См. также

SetupDiSetDriverInstallParams

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