Compartir a través de

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.

Sintaxis

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 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 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.

Observaciones

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

Puede especificar un valor de ExecutionLevel para los objetos siguientes:

  • Objetos de controlador de marco
  • Objetos de dispositivo de 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 del marco (versiones 1.9 y posteriores de Framework)
KMDF De forma predeterminada, el marco establece el ExecutionLevel valor de objetos de controlador de marco en WdfExecutionLevelDispatch.

UMDF de forma predeterminada, el marco establece el ExecutionLevel valor de 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 Framework-Based Controladores.

Requisitos

Requisito Valor
versión mínima de KMDF 1.0
versión mínima de UMDF 2.0
encabezado wdfobject.h (incluya Wdf.h)

Consulte también

WDF_OBJECT_ATTRIBUTES