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