WdfObjectReferenceActual-Funktion (wdfobject.h)
[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) |