WdfDpcWdmGetDpc 函数 (wdfdpc.h)
[仅适用于 KMDF]
WdfDpcWdmGetDpc 方法返回指向与指定框架 DPC 对象关联的 KDPC 结构的指针。
语法
PKDPC WdfDpcWdmGetDpc(
[in] WDFDPC Dpc
);
参数
[in] Dpc
框架 DPC 对象的句柄。
返回值
WdfDpcWdmGetDpc 返回指向与指定框架 DPC 对象关联的 KDPC 结构的指针。
如果驱动程序提供无效的对象句柄，则会发生 bug 检查。
注解
当基于框架的驱动程序调用 WdfDpcCreate 创建 DPC 对象时，框架会创建 KDPC 结构。
驱动程序可能从其 EvtDpcFunc 回调函数中调用 WdfDpcWdmGetDpc。
在删除框架 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) |