コールバック関数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 |