EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED função de retorno de chamada (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
A função de retorno de chamada de evento EvtDeviceWakeFromSxTriggered de um driver informa ao driver que seu dispositivo, que havia entrado anteriormente em um estado de dispositivo de baixa potência porque a energia do sistema foi reduzida, pode ter disparado um sinal de ativação.
Sintaxe
EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED EvtWdfDeviceWakeFromSxTriggered;
void EvtWdfDeviceWakeFromSxTriggered(
[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 EvtDeviceWakeFromSxTriggered , um driver deve chamar WdfDeviceInitSetPowerPolicyEventCallbacks.
Se o driver tiver registrado esse retorno de chamada, a estrutura a chamará depois de chamar a função de retorno de chamada EvtDeviceD0Entry do driver e antes de chamar a função de retorno de chamada EvtDeviceDisarmWakeFromSx do driver.
O hardware do sistema (BIOSes, placas-mãe, adaptadores de ônibus) às vezes pode soltar um sinal de ativação antes que o motorista do ônibus o detecte, mesmo que o sinal ative o sistema. Nesses casos, a função de retorno de chamada EvtDeviceWakeFromSxTriggered do driver não será chamada, mesmo que o dispositivo do driver tenha disparado um sinal de ativação.
Alguns ônibus combinam sinais de ativação de várias crianças. Se o dispositivo estiver conectado a um desses barramentos, a função de retorno de chamada poderá precisar determinar se o dispositivo atual disparou o sinal de ativação. Se o dispositivo fornecer uma trava de hardware que salva o estado disparado do dispositivo, é melhor marcar esse estado na função de retorno de chamada EvtDeviceDisarmWakeFromSx do driver, porque esse retorno de chamada é sempre chamado depois que o dispositivo é ativado, mesmo que o sinal de ativação tenha sido descartado.
Para obter mais informações sobre essa função de retorno de chamada, consulte Suporte à ativação do sistema.
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 |