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