WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB関数 (wdfusb.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB関数は、ドライバーが URB を指定して USB インターフェイスを選択できるように、WDF_USB_INTERFACE_SELECT_SETTING_PARAMS構造体を初期化します。

構文

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
Header 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