WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB 函数 (wdfusb.h)

[适用于 KMDF 和 UMDF]

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB 函数初始化 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 结构,以便驱动程序可以通过指定 URB 来选择 USB 接口。

语法

void WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PURB                                     Urb
);

参数

[out] Params

指向驱动程序分配 的WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 结构的指针。

[in] Urb

指向 URB 结构的指针。

返回值

备注

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB函数将WDF_USB_INTERFACE_SELECT_SETTING_PARAMS结构归零,并将其 Size 成员设置为结构的大小。 它还将 Type 成员设置为 WdfUsbInterfaceSelectSettingTypeUrb ,并将 Types.Urb.Urb 成员设置为 Urb 指针指定的值。

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

示例

下面的代码示例初始化 URB 结构,然后使用 结构作为 WdfUsbInterfaceSelectSetting 的输入。

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS  selectSettingParams;
URB  urb;
NTSTATUS  Status;

//
// Initialize the URB structure here.
//
...

//
// Initialize the WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 
// structure and call WdfUsbInterfaceSelectSetting.
//
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB(
                                      &selectSettingParams,
                                      &urb
                                      );

Status = WdfUsbInterfaceSelectSetting(
                                      UsbInterface,
                                      WDF_NO_OBJECT_ATTRIBUTES,
                                      &selectSettingParams
                                      );

要求

要求
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfusb.h (包括 Wdfusb.h)

另请参阅

URB

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING