enumeración WDF_EXECUTION_LEVEL (wdfobject.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El tipo de enumeración WDF_EXECUTION_LEVEL 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 = 0x00,
  WdfExecutionLevelInheritFromParent,
  WdfExecutionLevelPassive,
  WdfExecutionLevelDispatch
} WDF_EXECUTION_LEVEL;

Constantes

 
WdfExecutionLevelInvalid
Valor: 0x00
Reservado para uso del sistema.
WdfExecutionLevelInheritFromParent
El marco de trabajo usa el valor de IRQL máximo 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 valor con tipo WDF_EXECUTION_LEVEL.
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 está disponible en UMDF.

Comentarios

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

Puede especificar un valor ExecutionLevel para los objetos siguientes:

  • Objetos de controlador de marco
  • Objetos de dispositivo de marco
  • Objetos de archivo de marco
  • Objetos generales de 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 del 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 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, consulte Técnicas de sincronización para controladores de Framework-Based.

Requisitos

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

Consulte también

WDF_OBJECT_ATTRIBUTES