WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR関数 (wdfusb.h)

[KMDF と UMDF に適用]

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

構文

void WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PUSB_INTERFACE_DESCRIPTOR                Interface
);

パラメーター

[out] Params

ドライバーによって割り当てられた WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 構造体へのポインター。

[in] Interface

USB_INTERFACE_DESCRIPTOR構造体へのポインター。

戻り値

なし

解説

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR関数は、WDF_USB_INTERFACE_SELECT_SETTING_PARAMS構造体をゼロにし、その Size メンバーを構造体のサイズに設定します。 また、 Type メンバーを WdfUsbInterfaceSelectSettingTypeDescriptor に設定し、 Types.Descriptor.InterfaceDescriptor メンバーを Interface ポインターの値に設定します。

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

例

次のコード例では、 USB_INTERFACE_DESCRIPTOR 構造体を初期化し、 構造体を WdfUsbInterfaceSelectSetting への入力として使用します。

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS  selectSettingParams;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;
NTSTATUS  Status;

//
// Initialize the USB_INTERFACE_DESCRIPTOR structure here.
//
...

//
// Initialize the WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 
// structure and call WdfUsbInterfaceSelectSetting.
//
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
                                      &selectSettingParams,
                                      &interfaceDescriptor
                                      );

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

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfusb.h (Wdfusb.h を含む)

こちらもご覧ください

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB