EVT_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED função de retorno de chamada (wdfdevice.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento EvtDeviceD0EntryPostInterruptsEnabled de um driver executa operações específicas do dispositivo que são necessárias depois que o driver habilita as interrupções de hardware do dispositivo.

Sintaxe

EVT_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED EvtWdfDeviceD0EntryPostInterruptsEnabled;

NTSTATUS EvtWdfDeviceD0EntryPostInterruptsEnabled(
  [in] WDFDEVICE Device,
  [in] WDF_POWER_DEVICE_STATE PreviousState
)
{...}

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] PreviousState

Um enumerador do tipo WDF_POWER_DEVICE_STATE que identifica o estado de energia do dispositivo anterior.

Retornar valor

Se a função de retorno de chamada EvtDeviceD0EntryPostInterruptsEnabled não encontrar erros, ela deverá retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE.

Para obter mais informações sobre os valores retornados dessa função de retorno de chamada, consulte Relatando falhas de dispositivo.

Comentários

Para registrar uma função de retorno de chamada EvtDeviceD0EntryPostInterruptsEnabled , um driver deve chamar WdfDeviceInitSetPnpPowerEventCallbacks.

A função de retorno de chamada EvtDeviceD0EntryPostInterruptsEnabled é chamada em IRQL = PASSIVE_LEVEL, após o retorno da função de retorno de chamada EvtInterruptEnable do driver. Um driver poderá fornecer essa função se precisar executar operações específicas do dispositivo depois de habilitar uma interrupção, se essas operações não devem ser executadas em IRQL = DIRQL na função de retorno de chamada EvtInterruptEnable . Você não deve tornar essa função de retorno de chamada paginável.

Para obter mais informações sobre quando a estrutura chama essa função de retorno de chamada, consulte Cenários de gerenciamento de energia e PnP.

Para obter mais informações sobre como lidar com interrupções, consulte Tratamento de interrupções de hardware.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)
IRQL PASSIVE_LEVEL (consulte a seção Comentários)

Confira também

EvtDeviceD0ExitPreInterruptsDisabled