WdfFileObjectWdmGetFileObject-Funktion (wdffileobject.h)

[Gilt nur für KMDF]

Die WdfFileObjectWdmGetFileObject-Methode gibt das WDM-Dateiobjekt (Windows Driver Model) zurück, das einem angegebenen Frameworkdateiobjekt zugeordnet ist.

Syntax

PFILE_OBJECT WdfFileObjectWdmGetFileObject(
  [in] WDFFILEOBJECT FileObject
);

Parameter

[in] FileObject

Ein Handle für ein Frameworkdateiobjekt.

Rückgabewert

WdfFileObjectWdmGetFileObject gibt einen Zeiger auf die FILE_OBJECT-Struktur zurück, die dem angegebenen Frameworkdateiobjekt zugeordnet ist, oder NULL , wenn kein WDM-Dateiobjekt für das angegebene Frameworkdateiobjekt vorhanden ist.

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

Hinweise

Der Zeiger, den die WdfFileObjectWdmGetFileObject-Methode zurückgibt, ist gültig, bis das Frameworkdateiobjekt gelöscht wird. Wenn der Treiber eine EvtCleanupCallback-Funktion für das Frameworkdateiobjekt bereitstellt, ist der Zeiger gültig, bis die Rückruffunktion zurückgegeben wird.

Weitere Informationen zu Frameworkdateiobjekten finden Sie unter Frameworkdateiobjekte.

Beispiele

Im folgenden Codebeispiel wird ein Handle für das WDM-Dateiobjekt abgerufen, das einem angegebenen Frameworkdateiobjekt zugeordnet ist.

PFILE_OBJECT  pReturnedFileObject;

pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
Kopfzeile	wdffileobject.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

FILE_OBJECT