Freigeben über


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

Siehe auch

WdfObjectReference-