WdfDeviceResumeIdleWithTag macro (wdfdevice.h)

[Applies to KMDF and UMDF]

The WdfDeviceResumeIdleWithTag macro decrements the power reference count for a specified framework device object and assigns the driver's current file name and line number to the reference. The macro also assigns a tag value to the reference.

Syntax

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

Parameters

[in] Device

A handle to a framework device object.

[in] Tag

A driver-defined value that the framework stores as an identification tag for the power reference.

Return value

None

Remarks

A bug check occurs if the driver supplies an invalid object handle.

If the object's reference count becomes zero, the object might be deleted before WdfDeviceResumeIdleWithTag returns.

Calling WdfDeviceResumeIdleWithTag instead of WdfDeviceResumeIdle provides additional information (tag value, line number, and file name) that you can view in Microsoft debuggers. WdfDeviceResumeIdleWithTag uses the driver's current line number and file name.

You can view the tag, line number, and file name values by using the !wdfkd.wdftagtracker debugger extension.

Use !wdfkd.wdfdevice with verbose flags on and locate the link to !wdftagtracker in the output:

kd> !wdfdevice <handle> f 

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.15
Minimum UMDF version 2.15
Header wdfdevice.h (include Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI compliance rules DriverCreate, KmdfIrql, KmdfIrql2

See also

Debugging Power Reference Leaks in WDF

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag