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

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

Синтаксис

WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsW(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [out]          PSP_DEVINSTALL_PARAMS_W 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 (включая Setupapi.h)
Библиотека	Setupapi.lib
Набор API	ext-ms-win-setupapi-classinstallers-l1-1-0 (представлено в Windows 8)

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

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SetupDiSetDeviceInstallParams