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 傳回值模棱兩可的驅動程式應該以相同方式處理 TRUE 和 FALSE 的傳回值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | 任何層級 |
DDI 合規性規則 | HwStorPortProhibitedDIS (storport) |