WdfDeviceResumeIdleWithTag-Makro (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WdfDeviceResumeIdleWithTag Makros erhöht die Energiereferenzanzahl 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 zu einem Framework-Geräteobjekt.
[in] Tag
Ein vom Framework definierter Wert, der als Identifikationstag für die Energiereferenz gespeichert wird.
Rückgabewert
Nichts
Bemerkungen
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Wenn die Referenzanzahl des Objekts null wird, wird das Objekt möglicherweise gelöscht, bevor WdfDeviceResumeIdleWithTag- zurückgegeben wird.
Das Aufrufen WdfDeviceResumeIdleWithTag- anstelle von WdfDeviceResumeIdle- bietet zusätzliche Informationen (Tagwert, Zeilennummer und Dateiname), 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 !wdfkd.wdftagtracker Debuggererweiterung 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- | Universal |
| Minimale KMDF-Version | 1.15 |
| Mindest-UMDF-Version | 2.15 |
| Header- | wdfdevice.h (einschließen Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate, KmdfIrql, KmdfIrql2 |