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

Статья
03/22/2025

[Применимо к 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 и более поздние версии)
Объекты таймера платформы (платформы версии 1.9 и более поздние версии)

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

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

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

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

Требования

Требование	Ценность
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
Заголовок	wdfobject.h (include Wdf.h)

См. также

WDF_OBJECT_ATTRIBUTES

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