WdfDeviceStopIdleWithTag-Makro (wdfdevice.h)
[Gilt für KMDF und UMDF]
Das WdfDeviceStopIdleWithTag Makro erhöht die Leistungsreferenzanzahl 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
);
Die Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
[in] WaitForD0
Ein boolescher Wert, der angibt, wann WdfDeviceStopIdleWithTag- zurückgegeben wird. Wenn TRUE-, wird sie erst zurückgegeben, nachdem das angegebene Gerät den D0-Gerätestromzustand eingegeben hat. Wenn FALSE-, wird die Methode sofort zurückgegeben.
[in] Tag
Ein vom Framework definierter Wert, der als Identifikationstag für die Energiereferenz gespeichert wird.
Rückgabewert
Nichts
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 | Ein Geräteausfall ist aufgetreten, und das Gerät kann seinen D0-Energiezustand nicht eingeben. |
Die Methode gibt möglicherweise andere NTSTATUS-Wertezurück.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Wenn Ihr Treiber WdfDeviceStopIdleWithTag aufruft, um eine Verweisanzahl zu erhöhen, muss der Treiber WdfDeviceResumeIdleWithTag- aufrufen, um die Anzahl zu verringern.
Das Aufrufen WdfDeviceStopIdleWithTag- anstelle von WdfDeviceStopIdle- bietet zusätzliche Informationen (Tagwert, Zeilennummer und Dateiname), 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 !wdftagtracker Debuggererweiterung verwenden. Die Debuggererweiterung zeigt den Tagwert als Zeiger und 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 |
| Minimale KMDF-Version | 1.15 |
| Mindest-UMDF-Version | 2.15 |
| Kopfzeile | wdfdevice.h (einschließen Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | Siehe Abschnitt "Hinweise". |
| DDI-Complianceregeln | DriverCreate, KmdfIrql, KmdfIrql2 |