WdfObjectDereferenceWithTag-Makro
[Gilt für KMDF und UMDF]
Die WdfObjectDereferenceWithTag Makros erhöht die Referenzanzahl für ein angegebenes Frameworkobjekt und weist dem Verweis den aktuellen Dateinamen und die Zeilennummer des Treibers zu. Dieses Makro weist dem Verweis auch einen Tagwert zu.
Syntax
VOID WdfObjectDereferenceWithTag(
[in] WDFOBJECT Handle,
[in] PVOID Tag
);
Die Parameter
Handle [in]
Ein Handle für ein Frameworkobjekt.
Tag- [in]
Ein treiberdefinierter Wert, der einen Objektverweis identifiziert. Der Tagwert muss mit einem Tagwert übereinstimmen, den der Treiber zuvor für WdfObjectReferenceWithTag-bereitgestellt hat.
Rückgabewert
Keiner.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Wenn die Verweisanzahl des Objekts null wird, wird das Objekt möglicherweise gelöscht, bevor WdfObjectDereferenceWithTag zurückgegeben wird.
Das Aufrufen WdfObjectDereferenceActual- oder WdfObjectDereferenceWithTag- anstelle von WdfObjectDereference zusätzliche Informationen (Tagzeichenfolge, Zeilennummer und Dateiname) für Microsoft-Debugger bereitstellt. WdfObjectDereferenceActual- ermöglicht es Ihrem Treiber, die Zeilennummer und den Dateinamen anzugeben, während WdfObjectDereferenceWithTag die aktuelle Zeilennummer und den Dateinamen des Treibers verwendet.
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. Weitere Informationen zu Debuggererweiterungen finden Sie unter Debuggen eines KMDF-Treibers.
Weitere Informationen zu Objektverweisanzahlen finden Sie unter Framework Object Life Cycle.
Beispiele
Im folgenden Codebeispiel wird die Referenzanzahl eines Objekts verringert und dem Verweis ein Tagwert zugewiesen.
WdfObjectDereferenceWithTag(
object,
pTag
);
Anforderungen
Zielplattform |
universelle |
Minimale KMDF-Version |
1.0 |
Minimale UMDF-Version |
2.0 |
Kopfzeile |
Wdfobject.h (enthalten Wdf.h) |
Bibliothek |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |