EVT_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED função de retorno de chamada (wdfdevice.h)
[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) |