Функция WdfFileObjectGetDevice (wdffileobject.h)

Статья
03/22/2025

[Применимо к KMDF и UMDF]

Метод WdfFileObjectGetDevice возвращает объект устройства платформы, связанный с указанным объектом файла платформы.

Синтаксис

WDFDEVICE WdfFileObjectGetDevice(
  [in] WDFFILEOBJECT FileObject
);

Параметры

[in] FileObject

Дескриптор объекта файла платформы.

Возвращаемое значение

WdfFileObjectGetDevice возвращает дескриптор объекту устройства платформы, связанному с указанным объектом файла платформы.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Дополнительные сведения об объектах файлов платформы см. в разделе Framework File Objects.

Примеры

В следующем примере кода показано, как функция обратного вызова EvtFileClose может получить объект устройства платформы, связанный с указанным объектом файла платформы.

VOID
MyEvtFileClose(
    IN WDFFILEOBJECT  FileObject
    )
{
    WDFDEVICE device;

    device = WdfFileObjectGetDevice(FileObject);
...
}

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
Заголовок	wdffileobject.h (include Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Поделиться через