共用方式為


KeRemoveQueueDpc 函式 (wdm.h)

KeRemoveQueueDpc 例程會從系統 DPC 佇列中移除指定的 DPC 物件。

語法

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

參數

[in, out] Dpc

先前呼叫 KeInsertQueueDpc 例程所排入佇列的已初始化 DPC 物件的指標。

傳回值

如果 DPC 對象位於 DPC 佇列中,KeRemoveQueueDpc 會傳回 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 傳回值模棱兩可的驅動程式應該以相同方式處理 TRUEFALSE 的傳回值。

規格需求

需求
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL 任何層級
DDI 合規性規則 HwStorPortProhibitedDIS (storport)

另請參閱

KeInitializeDpc

KeInsertQueueDpc