EVT_WDF_DEVICE_ARM_WAKE_FROM_SX função de retorno de chamada (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
O de um driver EvtDeviceArmWakeFromSx braços de função de retorno de chamada de evento (ou seja, habilita) um dispositivo para que ele possa disparar um sinal de ativação enquanto estiver em um estado de dispositivo de baixa potência. O sinal de ativação faz com que o dispositivo insira seu estado de trabalho (D0) e faz com que o sistema insira seu estado de trabalho (S0).
Sintaxe
EVT_WDF_DEVICE_ARM_WAKE_FROM_SX EvtWdfDeviceArmWakeFromSx;
NTSTATUS EvtWdfDeviceArmWakeFromSx(
[in] WDFDEVICE Device
)
{...}
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
Valor de retorno
Se a função de retorno de chamada EvtDeviceArmWakeFromSx não encontrar nenhum erro, ela deverá retornar STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor de status para o qual NT_SUCCESS(status) é igual a FALSE.
Se NT_SUCCESS(status) for igual a FALSE, a estrutura chamará a função de retorno de chamada do driver EvtDeviceDisarmWakeFromSx. (A estrutura não relata uma falha de dispositivo para o gerenciador PnP.)
Observações
Para registrar uma função de retorno de chamada EvtDeviceArmWakeFromSx, um driver deve chamar WdfDeviceInitSetPowerPolicyEventCallbacks. Os drivers podem registrar uma função de retorno de chamada EvtDeviceArmWakeFromSx ou um EvtDeviceArmWakeFromSxWithReason função de retorno de chamada, mas não ambos.
Essa função de retorno de chamada manipula operações específicas do dispositivo que são necessárias para permitir que o dispositivo detecte um evento externo que dispara um sinal de ativação no barramento. A função de retorno de chamada EvtDeviceEnableWakeAtBus do motorista de ônibus lida com operações específicas do barramento, como habilitar o sinal de PME (Evento de Gerenciamento de Energia) do barramento PCI.
Se um driver tiver registrado um EvtDeviceArmWakeFromSx ou EvtDeviceArmWakeFromSxWithReason função de retorno de chamada, a estrutura o chama enquanto o dispositivo ainda está no estado de energia do dispositivo D0, antes que o motorista do ônibus reduza o estado de energia do dispositivo, mas depois que a estrutura enviar uma IRP de espera/ativação em nome do driver.
O processo ocorre na seguinte sequência:
- A estrutura determina que o sistema está prestes a entrar em um estado de sistema de baixa potência.
- A estrutura chama o do driver EvtDeviceArmWakeFromSx ou EvtDeviceArmWakeFromSxWithReason função de retorno de chamada.
- A estrutura solicita ao driver que o barramento do dispositivo diminua a potência do dispositivo.
Para obter mais informações sobre quando a estrutura chama essa função de retorno de chamada, consulte cenários de PnP e gerenciamento de energia.
Você não precisa fornecer um EvtDeviceArmWakeFromSx ou EvtDeviceArmWakeFromSxWithReason função de retorno de chamada se o dispositivo não exigir operações de hardware especiais que permitem que o dispositivo dispare um sinal de ativação.
Para obter mais informações sobre essa função de retorno de chamada, consulte Suporte aode Ativação do Sistema.
Requisitos
| Requisito | Valor |
|---|---|
| da 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 |