WdfObjectReferenceActual-Funktion (wdfobject.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfObjectReferenceActual-Methode erhöht die Verweisanzahl für ein angegebenes Frameworkobjekt und weist dem Verweis einen Tagwert, eine Zeilennummer und einen Dateinamen zu.

Syntax

void WdfObjectReferenceActual(
  [in]           WDFOBJECT Handle,
  [in, optional] PVOID     Tag,
  [in]           LONG      Line,
  [in]           PCCH      File
);

Parameter

[in] Handle

Ein Handle für ein Frameworkobjekt.

[in, optional] Tag

Ein vom Treiber definierter Wert, den das Framework als Identifikationstag für den Objektverweis speichert.

[in] Line

Ein numerischer Wert, der eine Zeilennummer in einer Treiberquelldatei darstellt.

[in] File

Ein Zeiger auf eine null-endende konstante Zeichenfolge, die den Namen einer Treiberquelldatei darstellt. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Keine

Bemerkungen

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

Wenn Ihr Treiber WdfObjectReferenceActual aufruft, um eine Verweisanzahl zu erhöhen, muss der Treiber WdfObjectDereferenceActual 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.

Weitere Informationen zu den Bereinigungsregeln für eine Frameworkobjekthierarchie finden Sie unter Framework Object Life Cycle.

Beispiele

Im folgenden Codebeispiel wird die Verweisanzahl eines Objekts erhöht und dem Verweis ein Tagwert, eine Zeilennummer und ein Dateiname zugewiesen.

WdfObjectReferenceActual(
                         object,
                         pTag,
                         line,
                         FILE_NAME
                         );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfobject.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf)

Weitere Informationen

WdfObjectReference