Compartilhar via

WDF_EXECUTION_LEVEL enumeração (wdfobject.h)

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

Sintaxe

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

Observações

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

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

  • Objetos do driver da estrutura
  • Objetos do dispositivo framework
  • Objetos de arquivo da estrutura
  • Objetos gerais da estrutura
  • Objetos de fila da estrutura (versões do Framework 1.9 e posteriores)
  • Objetos do temporizador da 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 para WdfExecutionLevelDispatch.

UMDF por padrão, a estrutura define o valor ExecutionLevel de objetos de driver de estrutura para WdfExecutionLevelPassive.

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

Para obter mais informações sobre os 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)

Consulte também

WDF_OBJECT_ATTRIBUTES

  • Last updated on