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 結構的指標。 此結構必須由 KeInitializeDpcKeInitializeThreadedDpc初始化。

[in, optional] SystemArgument1

指定驅動程式決定的內容數據。 此值會當做 SystemArgument1 參數傳遞至 DPC 物件的 CustomDpcCustomThreadedDpc 例程。

[in, optional] SystemArgument2

指定驅動程式決定的內容數據。 此值會當做 SystemArgument2 參數傳遞至 DPC 物件的 CustomDpcCustomThreadedDpc 例程。

傳回值

如果指定的 DPC 物件目前不在 DPC 佇列中,KeInsertQueueDpc 佇列 DPC,並傳 回 TRUE

言論

如果指定的 DPC 物件已排入佇列,則除了傳回 FALSE 之外,不會執行任何作業。 否則,DPC 物件會插入 DPC 佇列中。 如需 DPC 佇列的詳細資訊,請參閱 DPC 佇列組織

請注意,特定 DPC 物件及其所代表的函式可以在任何特定時間只排入佇列執行一次。

要求

要求 價值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 普遍
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何層級
DDI 合規性規則 HwStorPortProhibitedDIs(storport)MarkingQueuedIrps(wdm)

另請參閱

CustomDpc

CustomThreadedDpc

KeInitializeDpc

KeRemoveQueueDpc