WdfDeviceStopIdleWithTag-Makro (wdfdevice.h)

[Gilt für KMDF und UMDF]

Das WdfDeviceStopIdleWithTag-Makro erhöht 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

NTSTATUS WdfDeviceStopIdleWithTag(
    _In_ WDFDEVICE Device,
    _In_ BOOLEAN WaitForD0,
    _In_ PVOID Tag
);

Parameter

[in] Device

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

[in] WaitForD0

Ein boolescher Wert, der angibt, wann WdfDeviceStopIdleWithTag zurückgegeben wird. Bei TRUE wird erst zurückgegeben, nachdem das angegebene Gerät in den D0 Gerätestromzustand versetzt wurde. Wenn FALSE, gibt die Methode sofort zurück.

[in] Tag

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

Rückgabewert

Keine

Bemerkungen

Wenn der Vorgang erfolgreich ist, gibt WdfDeviceStopIdleWithTag STATUS_SUCCESS zurück.

Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_PENDING	Das Gerät wird asynchron eingeschaltet.
STATUS_INVALID_DEVICE_STATE	Der Treiber ist nicht der Besitzer der Energierichtlinie für das Gerät.
STATUS_POWER_STATE_INVALID	Es ist ein Gerätefehler aufgetreten, und das Gerät kann nicht in den D0-Energiezustand gelangen.

Die -Methode gibt möglicherweise andere NTSTATUS-Werte zurück.

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

Wenn Ihr Treiber WdfDeviceStopIdleWithTag aufruft, um eine Verweisanzahl zu erhöhen, muss der Treiber WdfDeviceResumeIdleWithTag aufrufen, um die Anzahl zu verringern.

Wenn Sie WdfDeviceStopIdleWithTag anstelle von WdfDeviceStopIdle aufrufen, werden zusätzliche Informationen (Tagwert, Zeilennummer und Dateiname) bereitgestellt, die Sie in Microsoft-Debuggern anzeigen können. WdfDeviceStopIdleWithTag 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 !wdftagtracker verwenden. Die Debuggererweiterung zeigt den Tagwert sowohl als Zeiger als auch als Eine Reihe von Zeichen an.

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	Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.
DDI-Complianceregeln	DriverCreate, KmdfIrql, KmdfIrql2

Weitere Informationen

Debuggen von Energieverweisverlusten in WDF

WdfDeviceResumeIdle

WdfDeviceResumeIdleWithTag

WdfDeviceStopIdle