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

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

  • Статья

Функция 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SetupDiSetDeviceInstallParams