WdfDeviceResumeIdleWithTag 宏 (wdfdevice.h)

[适用于 KMDF 和 UMDF]

WdfDeviceResumeIdleWithTag 宏递减指定框架设备对象的电源引用计数,并将驱动程序的当前文件名和行号分配给引用。 宏还会向引用分配标记值。

语法

void WdfDeviceResumeIdleWithTag(
  [in]  Device,
  [in]  Tag
);

参数

[in] Device

框架设备对象的句柄。

[in] Tag

驱动程序定义的值,框架将其存储为电源引用的标识标记。

返回值

备注

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

如果对象的引用计数变为零,则可能在 WdfDeviceResumeIdleWithTag 返回之前删除该对象。

调用 WdfDeviceResumeIdleWithTag 而不是 WdfDeviceResumeIdle 可提供可在 Microsoft 调试器中查看 (标记值、行号和文件名) 的其他信息。 WdfDeviceResumeIdleWithTag 使用驱动程序的当前行号和文件名。

可以使用 !wdfkd.wdftagtracker 调试器扩展查看标记、行号和文件名值。

使用上带有详细标志的 !wdfkd.wdfdevice ,并在输出中找到 指向 !wdftagtracker 的链接:

kd> !wdfdevice <handle> f 

要求

要求
目标平台 通用
最低 KMDF 版本 1.15
最低 UMDF 版本 2.15
标头 wdfdevice.h (包括 Wdf.h)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate、KmdfIrql、KmdfIrql2

另请参阅

在 WDF 中调试电源参考漏孔

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag