перечисление WDF_EXECUTION_LEVEL (wdfobject.h)

  • Статья

[Относится к KMDF и UMDF]

Тип перечисления WDF_EXECUTION_LEVEL указывает максимальное значение IRQL, при котором платформа будет вызывать функции обратного вызова событий, предоставленные драйвером для объекта платформы.

Синтаксис

typedef enum _WDF_EXECUTION_LEVEL {
  WdfExecutionLevelInvalid = 0x00,
  WdfExecutionLevelInheritFromParent,
  WdfExecutionLevelPassive,
  WdfExecutionLevelDispatch
} WDF_EXECUTION_LEVEL;

Константы

 
WdfExecutionLevelInvalid
Значение: 0x00
Зарезервировано для системного использования.
WdfExecutionLevelInheritFromParent
Платформа использует максимальное значение IRQL родительского объекта, если только объект не является объектом , требующим IRQL = DISPATCH_LEVEL (например, объект DPC). Это значение используется по умолчанию, если драйвер не задает WDF_EXECUTION_LEVEL типизированное значение.
WdfExecutionLevelPassive
Платформа всегда вызывает функции обратного вызова объекта в IRQL = PASSIVE_LEVEL.
WdfExecutionLevelDispatch
Платформа вызывает функции обратного вызова объекта в IRQL <= DISPATCH_LEVEL. Недоступно в UMDF.

Комментарии

Драйверы используют тип перечисления WDF_EXECUTION_LEVEL для указания элемента ExecutionLevelструктуры WDF_OBJECT_ATTRIBUTES объекта.

Можно указать значение ExecutionLevel для следующих объектов:

  • Объекты драйвера платформы
  • Объекты устройств платформы
  • Объекты файлов платформы
  • Общие объекты платформы
  • Объекты очередей платформы (Framework версии 1.9 и более поздние)
  • Объекты таймера платформы (framework версии 1.9 и более поздние)
KMDF По умолчанию платформа задает значение ExecutionLevel для объектов драйвера платформы wdfExecutionLevelDispatch.

UMDF По умолчанию платформа задает значение ExecutionLevel для объектов драйвера платформы wdfExecutionLevelPassive.

Значение по умолчанию ExecutionLevel для всех остальных объектов — WdfExecutionLevelInheritFromParent.

Дополнительные сведения об уровнях выполнения функций обратного вызова событий см. в разделе Методы синхронизации для драйверов Framework-Based.

Требования

Требование Значение
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfobject.h (включая Wdf.h)

См. также раздел

WDF_OBJECT_ATTRIBUTES