Функция WdfFileObjectWdmGetFileObject (wdffileobject.h)
[Применяется только к KMDF]
Метод WdfFileObjectWdmGetFileObject возвращает объект файла модели драйвера Windows (WDM), связанный с указанным объектом файла платформы.
Синтаксис
PFILE_OBJECT WdfFileObjectWdmGetFileObject(
[in] WDFFILEOBJECT FileObject
);
Параметры
[in] FileObject
Дескриптор объекта файла платформы.
Возвращаемое значение
WdfFileObjectWdmGetFileObject возвращает указатель на структуру FILE_OBJECT , связанную с указанным объектом файла платформы, или значение NULL , если объект WDM-файла для указанного объекта файла платформы отсутствует.
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Указатель, возвращаемый методом WdfFileObjectWdmGetFileObject , действителен до удаления объекта файла платформы. Если драйвер предоставляет функцию EvtCleanupCallback для объекта файла платформы, указатель будет действителен до тех пор, пока функция обратного вызова не вернет.
Дополнительные сведения об объектах файлов платформы см. в разделе Объекты файлов платформы.
Примеры
В следующем примере кода получается дескриптор объекта WDM-файла, связанный с указанным объектом файла платформы.
PFILE_OBJECT pReturnedFileObject;
pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdffileobject.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки платформы). |
| IRQL | <=DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |