Método IWDFDevice2::GetSystemPowerAction (wudfddi.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método GetSystemPowerAction retorna a ação de energia do sistema, se houver, que está ocorrendo no momento para o computador.

Sintaxe

POWER_ACTION GetSystemPowerAction();

Retornar valor

GetSystemPowerAction retorna um valor de enumerador tipo POWER_ACTION. O valor indica a ação de energia do sistema que está ocorrendo no momento para o computador. Para obter mais informações, consulte a seção Comentários a seguir.

Comentários

O método GetSystemPowerAction permite que um driver determine se a transição de energia de um dispositivo está ocorrendo porque o dispositivo está ocioso (ou acordando) ou porque todo o computador está entrando (ou saindo) de um estado de baixa potência.

O driver deve chamar GetSystemPowerAction somente das funções de retorno de chamada de evento que a estrutura chama quando o dispositivo está entrando em um estado de baixa potência ou retornando ao seu estado de trabalho.

O valor retornado por GetSystemPowerAction depende das seguintes situações:

• Se o computador estiver entrando em um estado de baixa potência quando o driver chamar GetSystemPowerAction, o método retornará o motivo pelo qual o computador está entrando no estado de baixa potência. Por exemplo, o método retornará PowerActionSleep se o computador estiver inserindo seu estado de baixa potência S1, S2 ou S3.
• Se o computador estiver retornando ao estado de trabalho (S0) de um estado de baixa potência quando o driver chamar GetSystemPowerAction, o método retornará o motivo pelo qual o computador entrou no estado de baixa potência. Por exemplo, o método retornará PowerActionSleep se o computador estiver deixando seu estado de baixa potência S1, S2 ou S3.
• Se o computador estiver ligando (depois de ter sido desativado) quando o driver chamar GetSystemPowerAction, o método retornará PowerActionNone.
• Se o dispositivo estiver entrando em um estado ocioso de baixa potência ou retornando ao estado de trabalho (D0) quando o driver chama GetSystemPowerAction, enquanto o restante do sistema permanece em seu estado de trabalho (S0), o método retorna PowerActionNone.
• Se o computador e o dispositivo estiverem em seus estados de trabalho quando o driver chamar GetSystemPowerAction, o método retornará PowerActionNone.

Exemplos

O exemplo de código a seguir obtém a interface IWDFDevice2 e chama GetSystemPowerAction.

   IWDFDevice2 *pDevice2 = NULL;
    HRESULT hrQI = pDevice->QueryInterface(IID_PPV_ARGS(&pDevice2));
    if (SUCCEEDED(hrQI))
    {
        POWER_ACTION powerAction = pDevice2->GetSystemPowerAction();
    }
...
    SAFE_RELEASE(pDevice2);

Requisitos

Confira também

IWDFDevice2