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 |