KeRemoveQueue 函式 (ntifs.h)

  • 發行項

KeRemoveQueue 例程可讓呼叫線程在佇列物件上將指標指向已清除佇列專案，或允許呼叫端等候佇列物件上的選擇性逾時間隔。

語法

PLIST_ENTRY KeRemoveQueue(
  [in, out]      PRKQUEUE        Queue,
  [in]           KPROCESSOR_MODE WaitMode,
  [in, optional] PLARGE_INTEGER  Timeout
);

參數

[in, out] Queue

呼叫端在非分頁集區中提供駐留記憶體之初始化佇列物件的指標。

[in] WaitMode

呼叫端正在等候的處理器模式，可以是 KernelMode 或 UserMode。 如果可以在 IRQL >= DISPATCH_LEVEL存取其堆疊上的任何專案，呼叫端必須指定 KernelMode。

[in, optional] Timeout

指定絕對或相對時間的變數指標，單位為100奈秒，等候到期。 如果 Timeout 的值是負數，則到期時間相對於目前的系統時間;否則，它是絕對的。 絕對到期時間會追蹤系統時間的任何變更;相對到期時間不會受到系統時間變更的影響。 此指標可以是 NULL。

傳回值

KeRemoveQueue 會傳回下列其中一項：

  • 如果有的話，從指定的佇列物件清除佇列專案的指標。
  • STATUS_TIMEOUT，如果指定的逾時間隔在進入可用前過期
  • STATUS_USER_APC，如果在呼叫線程的內容中傳遞使用者模式 APC
  • STATUS_ABANDONED，如果佇列已執行

備註

KeRemoveQueue 的呼叫端應該先測試其傳回值是STATUS_TIMEOUT還是STATUS_USER_APC，再存取任何項目成員。 針對 NULL 測試 KeRemoveQueue 的傳回值是程式設計錯誤。

指定 Timeout 的零值表示如果佇列目前是空的，呼叫端要等候項目的回應。指定 **NULL*逾時指標表示呼叫端願意無限期等候專案。

如果 WaitMode 參數是 UserMode，則可以在等候期間交換核心堆疊。 因此，呼叫端永遠不會嘗試在呼叫 KeRemoveQueue 並將 WaitMode 設定為 UserMode 時，嘗試在堆疊上傳遞參數。

在對 KeRemoveQueue 的呼叫中將 WaitMode 指定為 KernelMode，可防止呼叫線程的核心堆疊遭到交換，以及防止傳遞使用者模式異步過程呼叫 (APC) 。 當線程從 IRQL PASSIVE_LEVEL呼叫 KeRemoveQueue 時，不會防止傳遞核心模式 AP，例如 I/O 管理員用來完成 IRP 的 API。 這類核心模式 APC 的傳遞不會防止呼叫線程在佇列物件上等候，也不會在執行核心 APC 之後，以專案分派執行。

如需使用驅動程式管理的內部佇列的詳細資訊，請參閱 驅動程式管理的佇列。

規格需求

需求 值
目標平台 Universal
標頭 ntifs.h (包括 Ntifs.h、FltKernel.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm)

另請參閱

KeInsertHeadQueue

KeInsertQueue