WdfObjectReferenceActual-Funktion (wdfobject.h)

Artikel
03/22/2025

[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
);

Die Parameter

[in] Handle

Ein Handle für ein Frameworkobjekt.

[in, optional] Tag

Ein vom Framework definierter Wert, der als Identifikationstag für den Objektverweis gespeichert wird.

[in] Line

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

[in] File

Ein Zeiger auf eine mit Null beendete Konstantenzeichenfolge, die den Namen einer Treiberquelldatei darstellt. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

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

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

Beispiele

Im folgenden Codebeispiel wird die Referenzanzahl 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
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Kopfzeile	wdfobject.h (einschließen Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf)

Siehe auch

WdfObjectReference-

Freigeben über