структура WDF_USB_DEVICE_SELECT_CONFIG_PARAMS (wdfusb.h)

Статья
08/08/2023

[Относится к KMDF и UMDF]

Структура WDF_USB_DEVICE_SELECT_CONFIG_PARAMS указывает параметры конфигурации USB-устройства.

Синтаксис

typedef struct _WDF_USB_DEVICE_SELECT_CONFIG_PARAMS {
  ULONG                              Size;
  WdfUsbTargetDeviceSelectConfigType Type;
  union {
    struct {
      PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor;
      PUSB_INTERFACE_DESCRIPTOR     *InterfaceDescriptors;
      ULONG                         NumInterfaceDescriptors;
    } Descriptor;
    struct {
      PURB Urb;
    } Urb;
    struct {
      UCHAR           NumberConfiguredPipes;
      WDFUSBINTERFACE ConfiguredUsbInterface;
    } SingleInterface;
    struct {
      UCHAR                           NumberInterfaces;
      PWDF_USB_INTERFACE_SETTING_PAIR Pairs;
      UCHAR                           NumberOfConfiguredInterfaces;
    } MultiInterface;
  } Types;
} WDF_USB_DEVICE_SELECT_CONFIG_PARAMS, *PWDF_USB_DEVICE_SELECT_CONFIG_PARAMS;

Члены

Size

Размер данной структуры (в байтах).

Type

Значение типа WdfUsbTargetDeviceSelectConfigType, указывающее тип выбранной конфигурации или указывающее, что текущая конфигурация не настраивается.

Types

Types.Descriptor

Types.Descriptor.ConfigurationDescriptor

Если драйвер задает для элемента Type значение WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, этот элемент содержит предоставленный драйвером указатель на структуру USB_CONFIGURATION_DESCRIPTOR , задающую дескриптор конфигурации. Если этот указатель имеет значение NULL, платформа использует первую конфигурацию устройства. Дополнительные сведения о выборе конфигурации USB см. в разделе Примечания статьи WdfUsbTargetDeviceSelectConfig.

Types.Descriptor.InterfaceDescriptors

Если драйвер задает для параметра Типзначение WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, этот член содержит предоставленный драйвером указатель на массив USB_INTERFACE_DESCRIPTOR структур, представляющих интерфейсы, которые необходимо выбрать для конфигурации.

Types.Descriptor.NumInterfaceDescriptors

Если драйвер задает для параметра Type значение WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, этот элемент содержит количество элементов в массиве интерфейса, на который указывает Types.Descriptor.InterfaceDescriptors .

Types.Urb

Types.Urb.Urb

Если драйвер задает для параметра Типзначение WdfUsbTargetDeviceSelectConfigTypeUrb, этот член задает инициализированную драйвером структуру URB , используемую платформой для настройки устройства.

Types.SingleInterface

Types.SingleInterface.NumberConfiguredPipes

Если драйвер задает для параметра Типзначение WdfUsbTargetDeviceSelectConfigTypeSingleInterface, платформа предоставляет количество каналов, настроенных для интерфейса.

Types.SingleInterface.ConfiguredUsbInterface

Если драйвер задает для параметра Type значение WdfUsbTargetDeviceSelectConfigTypeSingleInterface, платформа предоставляет дескриптор для объекта интерфейса USB, представляющего настроенный интерфейс.

Types.MultiInterface

Types.MultiInterface.NumberInterfaces

Если драйвер задает для параметра Типзначение WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, этот член задает количество элементов в массиве Types.MultiInterface.Pairs .

Types.MultiInterface.Pairs

Если драйвер задает для параметра Типзначение WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, этот член указывает указатель на массив WDF_USB_INTERFACE_SETTING_PAIR структур, определяющих интерфейсы для выбора.

Types.MultiInterface.NumberOfConfiguredInterfaces

Если драйвер задает для параметра Типзначение WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs или WdfUsbTargetDeviceSelectConfigTypeMultiInterface, платформа предоставляет количество интерфейсов, настроенных для устройства.

Если драйвер задает для элемента Type значение WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, он может изменить конфигурацию USB-устройства. Все остальные значения используют текущую конфигурацию USB-устройства.

Требования

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

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

USB_CONFIGURATION_DESCRIPTOR

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SETTING_PAIR

WdfUsbTargetDeviceSelectConfigType

структура WDF_USB_DEVICE_SELECT_CONFIG_PARAMS (wdfusb.h)

Синтаксис

Члены

Комментарии

Требования

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

Обратная связь

Обратная связь

Дополнительные ресурсы