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 |