WdfDpcWdmGetDpc 函数 (wdfdpc.h)

[仅适用于 KMDF]

WdfDpcWdmGetDpc 方法返回指向与指定框架 DPC 对象关联的 KDPC 结构的指针。

语法

PKDPC WdfDpcWdmGetDpc(
  [in] WDFDPC Dpc
);

[in] Dpc

框架 DPC 对象的句柄。

WdfDpcWdmGetDpc 返回指向与指定框架 DPC 对象关联的 KDPC 结构的指针。

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

当基于框架的驱动程序调用 WdfDpcCreate 创建 DPC 对象时，框架会创建 KDPC 结构。

在删除框架 DPC 对象之前， WdfDpcWdmGetDpc 返回的指针是有效的。如果驱动程序为框架 DPC 对象提供 EvtCleanupCallback 函数，则指针在回调函数返回之前有效。

下面的代码示例返回指向与指定 DPC 对象关联的 KDPC 结构的指针。 WdfDpcCreate 代码示例演示如何创建指定的 DPC 对象。

PKDPC pWdmDpc;

pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);

要求	值
目标平台	通用
最低 KMDF 版本	1.0
标头	wdfdpc.h (包括 Wdf.h)
Library	Wdf01000.sys (请参阅框架库 Versioning.)
IRQL	任何级别
DDI 符合性规则	DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)