WDF_USB_INTERFACE_SELECT_SETTING_PARAMS结构(wdfusb.h)

[适用于 KMDF 和 UMDF]

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 结构包含 USB 接口的选择信息。

语法

typedef struct _WDF_USB_INTERFACE_SELECT_SETTING_PARAMS {
  ULONG                               Size;
  WdfUsbTargetDeviceSelectSettingType Type;
  union {
    struct {
      PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor;
    } Descriptor;
    struct {
      UCHAR SettingIndex;
    } Interface;
    struct {
      PURB Urb;
    } Urb;
  } Types;
} WDF_USB_INTERFACE_SELECT_SETTING_PARAMS, *PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS;

成员

Size

此结构的大小(以字节为单位)。

Type

WdfUsbTargetDeviceSelectSettingType类型化值,用于标识用于指定设备接口的技术。

Types

Types.Descriptor

Types.Descriptor.InterfaceDescriptor

如果 类型 成员 WdfUsbInterfaceSelectSettingTypeDescriptor,则此成员包含指向标识设备接口的 USB_INTERFACE_DESCRIPTOR 结构的指针。

Types.Interface

Types.Interface.SettingIndex

如果 类型 成员 WdfUsbInterfaceSelectSettingTypeSetting,则此成员包含一个索引值,该值标识接口的备用设置。 (接口由驱动程序传递给 WdfUsbInterfaceSelectSetting的接口对象句柄标识。

Types.Urb

Types.Urb.Urb

如果 类型 成员 WdfUsbInterfaceSelectSettingTypeUrb,则此成员包含指向描述设备接口的 URB 结构的指针。 URB 结构的 函数 成员必须URB_FUNCTION_SELECT_INTERFACE,并且必须根据需要为接口初始化其他成员。

言论

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 结构用作 WdfUsbInterfaceSelectSetting 方法的输入。

若要初始化 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 结构,驱动程序必须调用以下函数之一:

要求

要求 价值
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfusb.h (包括 Wdfusb.h)

另请参阅

URB

USB_INTERFACE_DESCRIPTOR

WdfUsbInterfaceSelectSetting

WdfUsbTargetDeviceSelectSettingType