WDF_EXECUTION_LEVEL enumeración (wdfobject.h)

[Se aplica a KMDF y UMDF]

El WDF_EXECUTION_LEVEL enumeración especifica el irQL máximo en el que el marco llamará a las funciones de devolución de llamada de eventos que un controlador ha proporcionado para un objeto de marco.

Syntax

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

Constantes

 
WdfExecutionLevelInvalid
Reservado para uso del sistema.
WdfExecutionLevelInheritFromParent
El marco usa el valor máximo de IRQL del elemento primario del objeto, a menos que el objeto sea uno que requiera IRQL = DISPATCH_LEVEL (por ejemplo, un objeto DPC). Este valor es el valor predeterminado si un controlador no especifica un WDF_EXECUTION_LEVEL con tipo.
WdfExecutionLevelPassive
El marco siempre llama a las funciones de devolución de llamada del objeto en IRQL = PASSIVE_LEVEL.
WdfExecutionLevelDispatch
El marco llama a las funciones de devolución de llamada del objeto en IRQL <= DISPATCH_LEVEL. No disponible en UMDF.

Observaciones

Los controladores usan el WDF_EXECUTION_LEVEL de enumeración para especificar el miembro ExecutionLevel de la estructura WDF_OBJECT_ATTRIBUTES un objeto .

Puede especificar un valor ExecutionLevel para los objetos siguientes:

  • Objetos de controlador de marco
  • Objetos de dispositivo del marco
  • Objetos de archivo de marco
  • Objetos generales del marco
  • Objetos de cola de Framework (versiones 1.9 y posteriores de Framework)
  • Objetos de temporizador de marco (versiones 1.9 y posteriores de Framework)
KMDF De forma predeterminada, el marco establece el valor ExecutionLevel de los objetos de controlador de marco en WdfExecutionLevelDispatch.

UMDF De forma predeterminada, el marco establece el valor ExecutionLevel de los objetos de controlador de marco en WdfExecutionLevelPassive.

El valor predeterminado de ExecutionLevel para todos los demás objetos es WdfExecutionLevelInheritFromParent.

Para obtener más información sobre los niveles de ejecución de las funciones de devolución de llamada de eventos, vea Técnicas de sincronización para Framework-Based controladores.

Requisitos

   
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfobject.h (incluir Wdf.h)

Vea también

WDF_OBJECT_ATTRIBUTES