Metodo IWDFDevice2::GetSystemPowerAction (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]

Il metodo GetSystemPowerAction restituisce l'azione di alimentazione del sistema, se presente, attualmente in corso per il computer.

Sintassi

POWER_ACTION GetSystemPowerAction();

Valore restituito

GetSystemPowerAction restituisce un valore enumeratore tipizzato POWER_ACTION. Il valore indica l'azione di alimentazione del sistema attualmente in corso per il computer. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Commenti

Il metodo GetSystemPowerAction consente a un driver di determinare se si sta verificando la transizione dell'alimentazione di un dispositivo perché il dispositivo è inattiva (o si sveglia) o perché l'intero computer sta entrando (o lasciando) uno stato a basso consumo.

Il driver deve chiamare GetSystemPowerAction solo dalle funzioni di callback degli eventi chiamate dal framework quando il dispositivo entra in uno stato a basso consumo o torna allo stato di lavoro.

Il valore restituito da GetSystemPowerAction dipende dalle situazioni seguenti:

• Se il computer sta immettendo uno stato a basso consumo quando il driver chiama GetSystemPowerAction, il metodo restituisce il motivo per cui il computer sta immettendo lo stato a basso consumo. Ad esempio, il metodo restituisce PowerActionSleep se il computer immette lo stato S1, S2 o S3 a basso consumo.
• Se il computer torna allo stato di funzionamento (S0) da uno stato a basso consumo quando il driver chiama GetSystemPowerAction, il metodo restituisce il motivo per cui il computer ha immesso lo stato a basso consumo. Ad esempio, il metodo restituisce PowerActionSleep se il computer lascia lo stato S1, S2 o S3 a basso consumo.
• Se il computer viene acceso (dopo essere stato spento) quando il driver chiama GetSystemPowerAction, il metodo restituisce PowerActionNone.
• Se il dispositivo entra in uno stato di inattività a basso consumo o torna allo stato di funzionamento (D0) quando il driver chiama GetSystemPowerAction, mentre il resto del sistema rimane nello stato funzionante (S0), il metodo restituisce PowerActionNone.
• Se il computer e il dispositivo si trovano entrambi negli stati di lavoro quando il driver chiama GetSystemPowerAction, il metodo restituisce PowerActionNone.

Esempio

L'esempio di codice seguente ottiene l'interfaccia IWDFDevice2 e quindi chiama GetSystemPowerAction.

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

Requisiti

Vedi anche

IWDFDevice2