WdfObjectDereferenceActual-Funktion (wdfobject.h)

[Gilt für KMDF und UMDF]

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

Syntax

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

Die Parameter

[in] Handle

Ein Handle für ein Frameworkobjekt.

[in, optional] Tag

Ein treiberdefinierter Wert, der einen Objektverweis identifiziert. Der Tagwert muss mit einem Tagwert übereinstimmen, den der Treiber zuvor für WdfObjectReferenceActual-bereitgestellt hat.

[in] Line

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

[in, optional] 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 die Verweisanzahl des Objekts null wird, wird das Objekt möglicherweise gelöscht, bevor WdfObjectDereferenceActual zurückgegeben wird.

Das Aufrufen WdfObjectDereferenceActual- oder WdfObjectDereferenceWithTag- anstelle von WdfObjectDereference zusätzliche Informationen (Tagzeichenfolge, Zeilennummer und Dateiname) für Microsoft-Debugger bereitstellt. WdfObjectDereferenceActual- ermöglicht es Ihrem Treiber, die Zeilennummer und den Dateinamen anzugeben, während WdfObjectDereferenceWithTag 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 und den Bereinigungsregeln für eine Frameworkobjekthierarchie finden Sie unter Framework Object Life Cycle.

Beispiele

Im folgenden Codebeispiel wird die Referenzanzahl eines Objekts verringert und dem Verweis ein Tagwert, eine Zeilennummer und ein Dateiname zugewiesen.

WdfObjectDereferenceActual(
                           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

WdfObjectDereference-

WdfObjectReferenceActual-