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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] DeviceInfoSet

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

[in, optional] DeviceInfoData

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

[out] DeviceInstallParams

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

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

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

Замечания

Заметка

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

Требования

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

См. также

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SetupDiSetDeviceInstallParams

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