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 物件及其所代表的函式可以排入佇列，以便在任何特定時間只執行一次。

規格需求

另請參閱

CustomDpc

CustomThreadedDpc

KeInitializeDpc

KeRemoveQueueDpc