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
例
次のコード例では、 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 を含む) |
こちらもご覧ください
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS