структура WDF_USB_DEVICE_SELECT_CONFIG_PARAMS (wdfusb.h)
[Относится к 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, платформа предоставляет количество интерфейсов, настроенных для устройства.
Комментарии
Структура WDF_USB_DEVICE_SELECT_CONFIG_PARAMS используется в качестве входных данных для WdfUsbTargetDeviceSelectConfig.
Чтобы инициализировать структуру 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
Если драйвер задает для элемента Type значение WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, он может изменить конфигурацию USB-устройства. Все остальные значения используют текущую конфигурацию USB-устройства.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия KMDF | 1,0 |
| Минимальная версия UMDF | 2,0 |
| Верхняя часть | wdfusb.h (включая Wdfusb.h) |