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


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

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

SP_DEVINFO_DATA

SetupDiSetSelectedDevice