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
                                      );

必要条件

関連項目

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