WdfDeviceResumeIdle-Makro (wdfdevice.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WdfDeviceResumeIdle-Methode informiert das Framework darüber, dass das angegebene Gerät nicht verwendet wird und in einen Gerätezustand mit geringer Leistung versetzt werden kann, wenn es im Leerlauf verbleibt.

Syntax

void WdfDeviceResumeIdle(
  [in]  Device
);

Parameter

[in] Device

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

Rückgabewert

Keine

Bemerkungen

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

Auf jeden Aufruf von WdfDeviceStopIdle muss schließlich ein Aufruf von WdfDeviceResumeIdle folgen, andernfalls kehrt das Gerät nie wieder in einen Energiesparzustand zurück, wenn es erneut im Leerlauf ist.

Das Aufrufen von WdfDeviceResumeIdleWithTag anstelle von WdfDeviceResumeIdle stellt zusätzliche Informationen (Tagwert, Zeilennummer und Dateiname) bereit, die Sie in Microsoft-Debuggern anzeigen können.

Beispiele

Im folgenden Codebeispiel wird das Framework darüber informiert, dass das angegebene Gerät nicht verwendet wird und in einen Gerätezustand mit geringer Leistung versetzt werden kann, wenn es im Leerlauf verbleibt.

WdfDeviceResumeIdle(device);

Anforderungen

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