enumeração WDF_EXECUTION_LEVEL (wdfobject.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O tipo de enumeração WDF_EXECUTION_LEVEL especifica o IRQL máximo no qual a estrutura chamará as funções de retorno de chamada de evento que um driver forneceu para um objeto de estrutura.

Syntax

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

Constantes

 
WdfExecutionLevelInvalid
Valor: 0x00
Reservado para uso do sistema.
WdfExecutionLevelInheritFromParent
A estrutura usa o valor IRQL máximo do pai do objeto, a menos que o objeto seja aquele que requer IRQL = DISPATCH_LEVEL (como um objeto DPC). Esse valor será o padrão se um driver não especificar um valor do tipo WDF_EXECUTION_LEVEL.
WdfExecutionLevelPassive
A estrutura sempre chama as funções de retorno de chamada do objeto em IRQL = PASSIVE_LEVEL.
WdfExecutionLevelDispatch
A estrutura chama as funções de retorno de chamada do objeto em IRQL <= DISPATCH_LEVEL. Não disponível no UMDF.

Comentários

Os drivers usam o tipo de enumeração WDF_EXECUTION_LEVEL para especificar o membro ExecutionLevel da estrutura WDF_OBJECT_ATTRIBUTES de um objeto.

Você pode especificar um valor ExecutionLevel para os seguintes objetos:

  • Objetos de driver de estrutura
  • Objetos de dispositivo de estrutura
  • Objetos de arquivo de estrutura
  • Objetos gerais da estrutura
  • Objetos de fila de estrutura (versões do Framework 1.9 e posteriores)
  • Objetos de temporizador de estrutura (versões do Framework 1.9 e posteriores)
KMDF Por padrão, a estrutura define o valor ExecutionLevel de objetos de driver de estrutura como WdfExecutionLevelDispatch.

UMDF Por padrão, a estrutura define o valor ExecutionLevel de objetos de driver de estrutura como WdfExecutionLevelPassive.

O valor padrão ExecutionLevel para todos os outros objetos é WdfExecutionLevelInheritFromParent.

Para obter mais informações sobre níveis de execução para funções de retorno de chamada de evento, consulte Técnicas de sincronização para drivers de Framework-Based.

Requisitos

Requisito Valor
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfobject.h (inclua Wdf.h)

Confira também

WDF_OBJECT_ATTRIBUTES