次の方法で共有


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 が完了し、UdeCx が EVT_UDECX_USB_ENDPOINT_START呼び出すまで、新しく転送された I/O 要求が失敗することを確認する必要があります。 通常、これらのタスクは、WdfIoQueuePurgeを呼び出すことによって実現されます。 この呼び出しは非同期であり、クライアント リバーは UdecxUsbEndpointPurgeComplete 呼び出す必要があります。

必要条件

要件 価値
サポートされる最小クライアント Windows 10
サポートされる最小サーバー Windows Server 2016
ターゲット プラットフォーム ウィンドウズ
最小 KMDF バージョン 1.15
ヘッダー udecxusbendpoint.h (Udecx.h を含む)
IRQL <=DISPATCH_LEVEL

関連項目

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

I/O キューの管理

UDE クライアント ドライバー を作成する