Функция 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) |