WDF_EXECUTION_LEVEL enumeração (wdfobject.h)

Artigo
03/22/2025

[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

Compartilhar via