Функция SetupDiGetSelectedDevice (setupapi.h)
Функция SetupDiGetSelectedDevice извлекает выбранный элемент сведений об устройстве в наборе сведений об устройстве.
Синтаксис
WINSETUPAPI BOOL SetupDiGetSelectedDevice(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Параметры
[in] DeviceInfoSet
Дескриптор набора сведений об устройстве , для которого извлекается выбранный элемент сведений об устройстве.
[out] DeviceInfoData
Указатель на структуру SP_DEVINFO_DATA , которая получает сведения о выбранном элементе сведений об устройстве для DeviceInfoSet. Вызывающий объект должен задать DeviceInfoData.cbSize до sizeof(SP_DEVINFO_DATA). Если устройство в настоящее время не выбрано, функция завершается сбоем и вызов Метода GetLastError возвращает ERROR_NO_DEVICE_SELECTED.
Возвращаемое значение
Функция возвращает ЗНАЧЕНИЕ TRUE , если оно выполнено успешно. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError.
Комментарии
SetupDiGetSelectedDevice обычно используется мастером установки.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
Целевая платформа | Персональный компьютер |
Верхняя часть | setupapi.h (включая Setupapi.h) |
Библиотека | Setupapi.lib |
DLL | Setupapi.dll |