次の方法で共有


KeRemoveQueueDpc 関数 (wdm.h)

KeRemoveQueueDpc ルーチンは、指定された DPC オブジェクトをシステム DPC キューから削除します。

構文

BOOLEAN KeRemoveQueueDpc(
  [in, out] PRKDPC Dpc
);

パラメーター

[in, out] Dpc

KeInsertQueueDpc ルーチンへの以前の呼び出しによってキューに入れられていた初期化された DPC オブジェクトへのポインター。

戻り値

KeRemoveQueueDpc は、DPC オブジェクトが DPC キューにある場合 TRUE を返します。 指定した DPC オブジェクトが現在 DPC キューにない場合、操作は実行されず、FALSE 返されます。

備考

指定された DPC オブジェクトが現在キューに登録されている場合、そのオブジェクトはキューから削除され、関連付けられている DPC ルーチンの呼び出しが取り消されます。

Windows Vista Service Pack 1 (SP1) および Windows Server 2008 以降では、TRUE の戻り値は常に、KeRemoveQueueDpc DPC ルーチンの実行を開始する前に DPC キューから DPC オブジェクトを正常に削除したことを意味します。 以前のバージョンの Windows では、KeRemoveQueueDpc が TRUE 返した場合でも、DPC ルーチンが実行されることがあります。 これらの以前のバージョンの Windows では、TRUE 戻り値のあいまいさを許容できないドライバーは、TRUE の戻り値と FALSE を同じように扱う必要があります。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 以降で使用できます。
ターゲット プラットフォーム 万国
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任意のレベル
DDI コンプライアンス規則 する hwStorPortProhibitedDDDIs(storport) する

関連項目

KeInitializeDpc

KeInsertQueueDpc