WdfFileObjectWdmGetFileObject-Funktion (wdffileobject.h)

[Gilt nur für KMDF]

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

Syntax

PFILE_OBJECT WdfFileObjectWdmGetFileObject(
  [in] WDFFILEOBJECT FileObject
);

Die Parameter

[in] FileObject

Ein Handle zu einem Framework-Dateiobjekt.

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.

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

Bemerkungen

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 Framework-Dateiobjekt bereitstellt, ist der Zeiger gültig, bis die Rückruffunktion zurückgegeben wird.

Weitere Informationen zu Framework-Dateiobjekten finden Sie unter Framework File Objects.

Beispiele

Das folgende Codebeispiel ruft ein Handle für das WDM-Dateiobjekt ab, das einem angegebenen Frameworkdateiobjekt zugeordnet ist.

PFILE_OBJECT  pReturnedFileObject;

pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);

Anforderungen

Siehe auch

FILE_OBJECT