WdfObjectReferenceWithTag-Makro
[Gilt für KMDF und UMDF]
Das WdfObjectReferenceWithTag-Makro erhöht die Verweisanzahl für ein angegebenes Frameworkobjekt und weist dem Verweis den aktuellen Dateinamen und die Zeilennummer des Treibers zu. Das Makro weist dem Verweis auch einen Tagwert zu.
Syntax
VOID WdfObjectReferenceWithTag(
[in] WDFOBJECT Handle,
[in] PVOID Tag
);
Parameter
Handle [in]
Ein Handle für ein Frameworkobjekt.
Tag [in]
Ein vom Treiber definierter Wert, den das Framework als Identifikationstag für den Objektverweis speichert.
Rückgabewert
Keine.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Wenn Ihr Treiber WdfObjectReferenceWithTag aufruft, um eine Verweisanzahl zu erhöhen, muss der Treiber WdfObjectDereferenceWithTag aufrufen, um die Anzahl zu verringern.
Der Aufruf von WdfObjectReferenceActual oder WdfObjectReferenceWithTag anstelle von WdfObjectReference stellt zusätzliche Informationen (Tagwert, Zeilennummer und Dateiname) für Microsoft-Debugger bereit. WdfObjectReferenceActual ermöglicht ihrem Treiber die Angabe der Zeilennummer und des Dateinamens, während WdfObjectReferenceWithTag 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 erhöht und dem Verweis ein Tagwert zugewiesen.
WdfObjectReferenceWithTag(
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 |