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

Weitere Informationen

WdfObjectReference