функция WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE (wdfusb.h)

Статья
02/27/2024

[Применимо к KMDF и UMDF]

Функция WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE инициализирует структуру WDF_USB_DEVICE_SELECT_CONFIG_PARAMS , чтобы драйвер может настроить устройство для использования одного указанного интерфейса.

Синтаксис

void WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE(
  [out] PWDF_USB_DEVICE_SELECT_CONFIG_PARAMS Params
);

Параметры

[out] Params

Указатель на структуру, выделенную драйвером WDF_USB_DEVICE_SELECT_CONFIG_PARAMS .

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

None

Remarks

Драйвер может использовать функцию WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE для выбора конфигурации, если интерфейс устройства указан дескриптором для объектов интерфейса USB.

Драйвер может использовать эту функцию только в том случае, если устройство имеет только один USB-интерфейс.

Функция WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE обнуляет структуру WDF_USB_DEVICE_SELECT_CONFIG_PARAMS и задает для элемента Size размер структуры. Он также задает для элемента Type значение WdfUsbTargetDeviceSelectConfigTypeSingleInterface.

Чтобы инициализировать структуру WDF_USB_DEVICE_SELECT_CONFIG_PARAMS , драйвер должен вызвать одну из следующих функций:

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB

Пример кода, использующего WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE, см. в разделе WdfUsbTargetDeviceSelectConfig.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfusb.h (включая Wdfusb.h)