WdfDeviceResumeIdleWithTag-Makro (wdfdevice.h)

[Gilt für KMDF und UMDF]

Das WdfDeviceResumeIdleWithTag-Makro verringert die Energieverweisanzahl für ein angegebenes Framework-Geräteobjekt und weist dem Verweis den aktuellen Dateinamen und die Zeilennummer des Treibers zu. Das Makro weist dem Verweis auch einen Tagwert zu.

Syntax

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] Tag

Ein treiberdefinierter Wert, den das Framework als Identifikationstag für den Energieverweis speichert.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Wenn die Verweisanzahl des Objekts null ist, wird das Objekt möglicherweise gelöscht, bevor WdfDeviceResumeIdleWithTag zurückgibt.

Wenn Sie WdfDeviceResumeIdleWithTag anstelle von WdfDeviceResumeIdle aufrufen, werden zusätzliche Informationen (Tagwert, Zeilennummer und Dateiname) bereitgestellt, die Sie in Microsoft-Debuggern anzeigen können. WdfDeviceResumeIdleWithTag verwendet die aktuelle Zeilennummer und den Dateinamen des Treibers.

Sie können die Werte für Tag, Zeilennummer und Dateinamen anzeigen, indem Sie die Debuggererweiterung !wdfkd.wdftagtracker verwenden.

Verwenden Sie !wdfkd.wdfdevice mit ausführlichen Flags, und suchen Sie den Link zu !wdftagtracker in der Ausgabe:

kd> !wdfdevice <handle> f 

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.15
UMDF-Mindestversion	2.15
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate, KmdfIrql, KmdfIrql2

Weitere Informationen

Debuggen von Energieverweisverlusten in WDF

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag