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

  • Статья

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

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

Синтаксис

WDFDEVICE WdfFileObjectGetDevice(
  [in] WDFFILEOBJECT FileObject
);

Параметры

[in] FileObject

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

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

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

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

Комментарии

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

Примеры

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

VOID
MyEvtFileClose(
    IN WDFFILEOBJECT  FileObject
    )
{
    WDFDEVICE device;

    device = WdfFileObjectGetDevice(FileObject);
...
}

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdffileobject.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)