Метод IWDFUsbInterface::SelectSetting (wudfusb.h)

Статья
02/27/2024

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод SelectSetting выбирает указанный альтернативный параметр в ИНТЕРФЕЙСе USB.

Синтаксис

HRESULT SelectSetting(
  [in] UCHAR SettingNumber
);

Параметры

[in] SettingNumber

Параметр, который нужно выбрать в ИНТЕРФЕЙСе USB.

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

SelectSetting возвращает одно из следующих значений:

Код возврата	Описание
S_OK	SelectSetting успешно выбрал параметр, указанный параметром SettingNumber .
E_OUTOFMEMORY	В selectSetting обнаружен сбой выделения.
Код ошибки, определенный в Winerror.h	Это значение соответствует коду ошибки, возвращенной API WinUsb.

Платформа автоматически выбирает ноль конфигурации, ноль интерфейса и альтернативный ноль параметров. Чтобы изменить альтернативный параметр, драйвер может вызвать SelectSetting.

Дополнительные сведения о дескрипторов конфигурации USB

Примеры


hr = pIWDFUsbInterface->SelectSetting(SettingNumber);

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1.5
Верхняя часть	wudfusb.h (включая Wudfusb.h)
DLL	WUDFx.dll

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

IWDFUsbInterface

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