WdfDpcEnqueue 函式 (wdfdpc.h)

  • 發行項

[僅適用於 KMDF]

WdfDpcEnqueue 方法會排程執行 DPC 物件的 EvtDpcFunc 回呼函式。

語法

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

參數

[in] Dpc

架構 DPC 物件的句柄。

傳回值

如果 WdfDpcEnqueue 成功將指定的 DPC 物件新增至系統的 DPC 佇列，則會傳回 TRUE。 否則，方法會傳回 FALSE。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

如果指定的 DPC 物件尚未在佇列中， WdfDpcEnqueue 方法會將指定的 DPC 物件新增至系統的 DPC 佇列。 (如果 DPC 物件已經在佇列中，此方法會傳回 FALSE.) 當系統未執行較高優先順序的工作時，它會從佇列中移除 DPC 物件，並呼叫物件的 EvtDpcFunc 回呼函式。

在回呼函式執行之後，後續對 WdfDpcEnqueue 的呼叫會將 DPC 物件新增回 DPC 佇列。

如需使用 DPC 物件的詳細資訊，請參閱 維護中斷。

範例

下列程式代碼範例會排程與 DPC 對象相關聯的回呼函式執行。 此範例使用 WdfDpcEnqueue 方法的傳回值做為包含函式的傳回值。 WdfDpcCreate 程式代碼範例示範如何建立 DPC 物件。

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfdpc.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL 任何層級
DDI 合規性規則 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

EvtDpcFunc

WdfDpcCreate