[僅適用於 KMDF]
WdfDpcWdmGetDpc 方法會傳回與指定架構 DPC 物件相關聯之 KDPC 結構的指標。
語法
PKDPC WdfDpcWdmGetDpc(
[in] WDFDPC Dpc
);
參數
[in] Dpc
架構 DPC 物件的句柄。
返回值
WdfDpcWdmGetDpc 會傳回與指定架構 DPC 物件相關聯的 KDPC 結構的指標。
如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。
備註
架構會在架構型驅動程式呼叫 WdfDpcCreate 建立 DPC 物件時,建立 KDPC 結構。
驅動程式可以從其 EvtDpcFunc 回呼函式內呼叫 WdfDpcWdmGetDpc。
WdfDpcWdmGetDpc 傳回的指標有效,直到刪除架構 DPC 物件為止。 如果驅動程式為 Framework DPC 物件提供 EvtCleanupCallback 函式,則指標會有效,直到回呼函式傳回為止。
範例
下列程式代碼範例會傳回與指定 DPC 對象相關聯的 KDPC 結構的指標。 WdfDpcCreate 程式代碼範例示範如何建立指定的 DPC 物件。
PKDPC pWdmDpc;
pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);
需求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
標題 | wdfdpc.h (包括 Wdf.h) |
程式庫 | Wdf01000.sys (請參閱架構連結庫版本控制。) |
IRQL | 任何層級 |
DDI 合規性規則 | DriverCreate(kmdf),KmdfIrql(kmdf),KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf) |