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

Статья
11/20/2024

Наборы функций SetupDiSetSelectedDriver или сброс, выбранный драйвер для элемента сведений об устройстве или выбранного драйвера класса для набора сведений об устройстве.

Синтаксис

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

Параметры

[in] DeviceInfoSet

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

[in, out] DeviceInfoData

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

[in, out] DriverInfoData

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

Если DriverInfoData.ЗарезервированныеNULL, вызывающий объект запрашивает поиск узла драйвера с указанными параметрами (DriverType, Descriptionи ProviderName). Если совпадение найдено, этот узел драйвера выбран. Поле зарезервированного обновляется для выходных данных, чтобы отразить фактический узел драйвера, в котором было найдено совпадение. Если совпадение не найдено, функция завершается ошибкой, и вызов getLastError возвращает ERROR_INVALID_PARAMETER.

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

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

Замечания

Если вызывающий объект SetupDiSetSelectedDriver является членом группы "Администраторы", то для класса устройства устанавливается класс выбранного драйвера, если два класса отличаются.

Если DriverInfoDatanull, SetupDiSetSelectedDriver сбрасывает выбранный драйвер. В результате отсутствует выбранный драйвер.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	setupapi.h (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

SetupDiGetSelectedDriver

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