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

Функция 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. Если указан этот параметр и DeviceInfoData имеет значение NULL, драйвер должен быть членом списка драйверов глобального класса для DeviceInfoSet. Если этот параметр имеет значение NULL, выбранный драйвер сбрасывается для элемента сведений об устройстве, если указан параметр DeviceInfoData , или набора сведений об устройстве, если DeviceInfoData имеет значение NULL.

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

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

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

Комментарии

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

Если driverInfoData имеет значение NULL, SetupDiSetSelectedDriver сбрасывает выбранный драйвер. В результате не выбран драйвер.

Требования

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

SetupDiGetSelectedDriver