função de retorno de chamada EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0 (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
A função de retorno de chamada de evento EvtDeviceDisarmWakeFromS0 de um driver desarma (ou seja, desabilita) a capacidade de um dispositivo de disparar um sinal de ativação enquanto estiver em um estado de dispositivo de baixa potência, se o sistema permanecer no estado de funcionamento do sistema (S0).
Sintaxe
EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0 EvtWdfDeviceDisarmWakeFromS0;
void EvtWdfDeviceDisarmWakeFromS0(
[in] WDFDEVICE Device
)
{...}
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
Retornar valor
Nenhum
Comentários
Para registrar uma função de retorno de chamada EvtDeviceDisarmWakeFromS0 , um driver deve chamar WdfDeviceInitSetPowerPolicyEventCallbacks. O driver também deve definir IdleCanWakeFromS0 no membro IdleCaps de sua estrutura WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS .
Se o driver tiver registrado uma função de retorno de chamada EvtDeviceDisarmWakeFromS0 , a estrutura a chamará depois que o motorista do ônibus determinar que um evento despertou o dispositivo e depois que o motorista do ônibus concluir posteriormente o IRP de espera/ativação. Antes de chamar a função de retorno de chamada EvtDeviceDisarmWakeFromS0EvtDeviceDisarmWakeFromS0 do driver, a estrutura chama as funções de retorno de chamada EvtDeviceD0Entry, EvtInterruptEnable e EvtDeviceWakeFromS0Triggered do driver.
A função de retorno de chamada EvtDeviceDisarmWakeFromS0 deve executar todas as operações de hardware necessárias para desabilitar a capacidade do dispositivo de disparar um sinal de ativação depois que a energia for reduzida.
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 essa função de retorno de chamada, consulte Suporte à ociosidade de energia para baixo.
A função de retorno de chamada EvtDeviceDisarmWakeFromS0 é chamada em IRQL = PASSIVE_LEVEL. Você não deve tornar essa função de retorno de chamada paginável.
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) |