KeInsertQueueDpc 函式 (wdm.h)
KeInsertQueueDpc 例程會將 DPC 排入佇列以供執行。
語法
BOOLEAN KeInsertQueueDpc(
[in, out] PRKDPC Dpc,
[in, optional] PVOID SystemArgument1,
[in, optional] __drv_aliasesMem PVOID SystemArgument2
);
參數
[in, out] Dpc
DPC 物件的 KDPC 結構的指標。 這個結構必須由 KeInitializeDpc 或 KeInitializeThreadedDpc 初始化。
[in, optional] SystemArgument1
指定驅動程式決定的內容數據。 這個值會當做 SystemArgument1 參數傳遞至 DPC 物件的 CustomDpc 或 CustomThreadedDpc 例程。
[in, optional] SystemArgument2
指定驅動程式決定的內容數據。 這個值會當做 SystemArgument2 參數傳遞至 DPC 物件的 CustomDpc 或 CustomThreadedDpc 例程。
傳回值
如果指定的 DPC 物件目前不在 DPC 佇列中, KeInsertQueueDpc 會將 DPC 排入佇列並傳回 TRUE。
備註
如果指定的 DPC 物件已排入佇列,則除了傳回 FALSE 以外,不會執行任何作業。 否則,DPC 物件會插入 DPC 佇列中。 如需 DPC 佇列的詳細資訊,請參閱 DPC 佇列的組織。
請注意,特定 DPC 物件及其所代表的函式可以排入佇列,以便在任何特定時間只執行一次。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | 任何層級 |
DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 MarkingQueuedIrps (wdm) |