次の方法で共有


WdfIoQueueStopAndPurgeSynchronously 関数 (wdfio.h)

[KMDF と UMDF に適用]

WdfIoQueueStopAndPurgeSynchronously メソッドは、I/O キューが新しい I/O 要求を配信するのを防ぎ、フレームワークが既存の未処理の要求とドライバー所有の取り消し可能な要求を取り消しますが、キューは新しい要求を受信して格納します。

構文

void WdfIoQueueStopAndPurgeSynchronously(
  [in] WDFQUEUE Queue
);

パラメーター

[in] Queue

フレームワーク キュー オブジェクトへのハンドル。

戻り値

なし

解説

このメソッドは、未処理の要求とドライバー所有のすべての要求 (この呼び出しが行われた後にキューに追加された要求は含まない) が完了または取り消された後にを返します。 WdfIoQueueStopAndPurgeSynchronously が進行中に新しい要求が挿入された場合、これらの新しい要求は、ドライバーが WdfIoQueueStart を呼び出すまで配信されません。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.11
最小 UMDF バージョン 2.0
Header wdfio.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf)

こちらもご覧ください

WdfIoQueueStopAndPurge