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

Статья
11/20/2024

Функция 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 (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

SetupDiSetSelectedDriver

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