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

Artigo
02/07/2025

[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 .]

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();

Valor de retorno

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.

Observações

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á inserindo (ou deixando) 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 GetSystemPowerAction depende das seguintes situações:

Se o computador estiver inserindo 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 seu 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 habilitando (depois de ter sido desativado) quando o driver chamar GetSystemPowerAction, o método retornará PowerActionNone.
Se o dispositivo estiver inserindo 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.

Para obter mais informações sobre estados de baixa potência, consulte Um dispositivo insere um Low-Power State.

Exemplos

O exemplo de código a seguir obtém a interface de IWDFDevice2 e, em seguida, 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

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)
de DLL	WUDFx.dll

Consulte também

IWDFDevice2

Compartilhar via