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