WdfObjectReferenceWithTag-Makro
[Gilt für KMDF und UMDF]
Das WdfObjectReferenceWithTag Makro erhöht die Referenzanzahl 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
);
Die Parameter
Handle [in]
Ein Handle für ein Frameworkobjekt.
Tag- [in]
Ein vom Framework definierter Wert, der als Identifikationstag für den Objektverweis gespeichert wird.
Rückgabewert
Keiner.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Wenn Ihr Treiber WdfObjectReferenceWithTag- aufruft, um eine Verweisanzahl zu erhöhen, muss der Treiber WdfObjectDereferenceWithTag- aufrufen, um die Anzahl zu verringern.
Das Aufrufen WdfObjectReferenceActual- oder WdfObjectReferenceWithTag- anstelle von WdfObjectReference zusätzliche Informationen (Tagwert, Zeilennummer und Dateiname) für Microsoft-Debugger bereitstellt. WdfObjectReferenceActual- ermöglicht es Ihrem Treiber, die Zeilennummer und den Dateinamen anzugeben, 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 !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 erhöht und dem Verweis ein Tagwert zugewiesen.
WdfObjectReferenceWithTag(
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 |