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

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

  • Статья

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

Синтаксис

WINSETUPAPI BOOL SetupDiGetSelectedDriverA(
  [in]           HDEVINFO           DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA   DeviceInfoData,
  [out]          PSP_DRVINFO_DATA_A DriverInfoData
);

Параметры

[in] DeviceInfoSet

Дескриптор набора сведений об устройстве , для которого требуется извлечь выбранный драйвер.

[in, optional] DeviceInfoData

Указатель на структуру SP_DEVINFO_DATA , указывающую элемент сведений об устройстве, представляющий устройство в DeviceInfoSet , для которого требуется извлечь выбранный драйвер. Этот параметр является необязательным и может иметь значение NULL. Если указан этот параметр, SetupDiGetSelectedDriver извлекает выбранный драйвер для указанного устройства. Если этот параметр имеет значение NULL, SetupDiGetSelectedDriver извлекает выбранный драйвер класса в списке драйверов глобального класса, связанном с DeviceInfoSet.

[out] DriverInfoData

Указатель на структуру SP_DRVINFO_DATA , получающую сведения о выбранном драйвере.

Возвращаемое значение

Функция возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError. Если драйвер не выбран для указанного экземпляра устройства, зарегистрированная ошибка ERROR_NO_DRIVER_SELECTED.

Комментарии

Примечание

Заголовок setupapi.h определяет SetupDiGetSelectedDriver как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

SetupDiSetSelectedDriver