コールバック関数EVT_UDECX_USB_ENDPOINT_RESET (udecxusbendpoint.h)

  • [アーティクル]

USB デバイス エミュレーション クラス拡張機能 (UdeCx) は、このコールバック関数を呼び出して、仮想 USB デバイスのエンドポイントをリセットします。

構文

EVT_UDECX_USB_ENDPOINT_RESET EvtUdecxUsbEndpointReset;

void EvtUdecxUsbEndpointReset(
  [in] UDECXUSBENDPOINT UdecxUsbEndpoint,
  [in] WDFREQUEST Request
)
{...}

パラメーター

[in] UdecxUsbEndpoint

リセットするエンドポイントを表す UDE エンドポイント オブジェクトへのハンドル。 クライアント ドライバーは、 UdecxUsbEndpointCreate の前回の呼び出しでこのポインターを取得しました。

[in] Request

エンドポイントをリセットする要求を表すフレームワーク要求オブジェクトへのハンドル。

戻り値

なし

解説

クライアント ドライバーは、 UdecxUsbEndpointInitSetCallbacks への以前の呼び出しで、その実装への関数ポインターを指定することで、このコールバック関数を登録しました。

リセット要求は、失敗した I/O 転送の原因となるエンドポイントのエラー状態をクリアします。 その時点で、UdeCx は EVT_UDECX_USB_ENDPOINT_RESET コールバック関数を呼び出すことができます。 その呼び出しは非同期です。 クライアント ドライバーは、要求を完了し、 WdfRequestCompleteWithInformation メソッド を呼び出すことによって状態で完了を通知します。 (これは、UDECX クライアントが要求パラメーターを使用する唯一の方法です)。

要件

要件 値
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
最小 KMDF バージョン 1.15
Header udecxusbendpoint.h (Udecx.h を含む)
IRQL <=DISPATCH_LEVEL

こちらもご覧ください

アーキテクチャ:USB デバイス エミュレーション (UDE)

USB パイプ エラーからの回復方法

I/O キューの管理

UDE クライアント ドライバーを記述する