Método IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]
Um driver OnArmWakeFromSx 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 o sistema insira seu estado de trabalho (S0).
Sintaxe
HRESULT OnArmWakeFromSx(
[in] IWDFDevice *pWdfDevice
);
Parâmetros
[in] pWdfDevice
Um ponteiro para a interface IWDFDevice do objeto do dispositivo que representa um dos dispositivos do driver.
Valor de retorno
Se a operação for bem-sucedida, a função de retorno de chamada OnArmWakeFromSx deverá retornar S_OK ou outro valor de status para o qual SUCCEEDED(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor de status para o qual SUCCEEDED(status) é igual a FALSE.
Se SUCCEEDED(status) for igual a FALSE, a estrutura chamará o do driver IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx função de retorno de chamada. (A estrutura não relata uma falha de dispositivo para o gerenciador PnP.)
Observações
O driver deverá fornecer uma função de retorno de chamada OnArmWakeFromSx se o driver der suporte à interface de IPowerPolicyCallbackWakeFromSx.
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. O motorista do barramento no modo kernel lida com operações específicas do ônibus, como habilitar o sinal de PME (Evento de Gerenciamento de Energia) do barramento PCI.
Se um driver tiver registrado uma função de retorno de chamada OnArmWakeFromSx, a estrutura a chamará enquanto o dispositivo ainda estiver no estado de energia do dispositivo D0, antes que o driver de barramento reduza o estado de energia do dispositivo, mas depois que a estrutura enviar um 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 a função de retorno de chamada OnArmWakeFromSx do driver.
- 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 noumDF.
Você não precisa fornecer uma função de retorno de chamada OnArmWakeFromSx 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 Wake-Up de sistema de suporte em drivers baseados em UMDF.
Requisitos
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.9 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
Consulte também
IPowerPolicyCallbackWakeFromSx