WdfDpcWdmGetDpc 函式 (wdfdpc.h)

[僅適用於 KMDF]

WdfDpcWdmGetDpc 方法會傳回與指定架構 DPC 對象相關聯的 KDPC 結構的指標。

語法

PKDPC WdfDpcWdmGetDpc(
  [in] WDFDPC Dpc
);

[in] Dpc

架構 DPC 物件的句柄。

WdfDpcWdmGetDpc 會傳回與指定架構 DPC 對象相關聯的 KDPC 結構的指標。

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

當架構型驅動程式呼叫 WdfDpcCreate 以建立 DPC 物件時，架構會建立 KDPC 結構。

驅動程式可能會從其 EvtDpcFunc 回呼函式內呼叫 WdfDpcWdmGetDpc。

WdfDpcWdmGetDpc 傳回的指標有效，直到刪除架構 DPC 對象為止。如果驅動程式為架構 DPC 物件提供 EvtCleanupCallback 函式，則指標會有效，直到回呼函式傳回為止。

下列程式代碼範例會傳回與指定 DPC 對象相關聯的 KDPC 結構的指標。 WdfDpcCreate 程式代碼範例示範如何建立指定的 DPC 物件。

PKDPC pWdmDpc;

pWdmDpc = WdfDpcWdmGetDpc(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)