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

  • [アーティクル]

USB デバイス エミュレーション クラス拡張機能 (UdeCx) は、このコールバック関数を呼び出して、エンドポイントのキューへの I/O 要求のキューを停止し、未処理の要求を取り消します。

構文

EVT_UDECX_USB_ENDPOINT_PURGE EvtUdecxUsbEndpointPurge;

void EvtUdecxUsbEndpointPurge(
  [in] UDECXUSBENDPOINT UdecxUsbEndpoint
)
{...}

パラメーター

[in] UdecxUsbEndpoint

I/O 要求を取り消す必要があるエンドポイントを表す UDE エンドポイント オブジェクトへのハンドル。 クライアント ドライバーは、 UdecxUsbEndpointCreate の前回の呼び出しでこのポインターを取得しました。

戻り値

なし

解説

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

実装では、エンドポイントのキューから転送されたすべての I/O が完了し、新しく転送された I/O 要求が失敗し、UdeCx が EVT_UDECX_USB_ENDPOINT_STARTを呼び出すまで、クライアント ドライバーが必要です。 通常、これらのタスクは WdfIoQueuePurge を呼び出すことによって実現されます。 この呼び出しは非同期であり、クライアント リバーは UdecxUsbEndpointPurgeComplete を呼び出す必要があります。

要件

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

こちらもご覧ください

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

I/O キューの管理

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