WdfObjectDereferenceWithTag-Makro

[Gilt für KMDF und UMDF]

Das Makro WdfObjectDereferenceWithTag dekrementiert die Verweisanzahl 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
);

Parameter

Handle [in]
Ein Handle für ein Frameworkobjekt.

Tag [in]
Ein vom Treiber definierter Wert, der einen Objektverweis identifiziert. Der Tagwert muss mit einem Tagwert übereinstimmen, den der Treiber zuvor für WdfObjectReferenceWithTag angegeben hat.

Rückgabewert

Keine.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Wenn die Verweisanzahl des Objekts 0 ist, wird das Objekt möglicherweise gelöscht, bevor WdfObjectDereferenceWithTag zurückgibt.

Das Aufrufen von WdfObjectDereferenceActual oder WdfObjectDereferenceWithTag anstelle von WdfObjectDereference stellt zusätzliche Informationen (Tagzeichenfolge, Zeilennummer und Dateinamen) für Microsoft-Debugger bereit. WdfObjectDereferenceActual ermöglicht ihrem Treiber die Angabe der Zeilennummer und des Dateinamens, 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 Debuggererweiterung !wdftagtracker verwenden. Die Debuggererweiterung zeigt den Tagwert sowohl als Zeiger als auch als Eine Reihe von Zeichen an. Weitere Informationen zu Debuggererweiterungen finden Sie unter Debuggen eines KMDF-Treibers.

Weitere Informationen zur Anzahl der Objektverweis finden Sie unter Framework Object Life Cycle.

Beispiele

Im folgenden Codebeispiel wird die Verweisanzahl eines Objekts verringert und dem Verweis ein Tagwert zugewiesen.

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

Anforderungen

Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Header	Wdfobject.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

WdfObjectDereference

WdfObjectReferenceWithTag