WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB函式 (wdfusb.h)

發行項
02/27/2024

[適用於 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 結構，驅動程式必須呼叫下列其中一個函式：

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

範例

下列程式代碼範例會初始化 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
                                      );