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)
Wdf01000.sys(KMDF):WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate、KmdfIrql、KmdfIrql2

另请参阅

在 WDF 中调试电源引用泄漏

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag