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 informazioni, vedi Introduzione a 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 POWER_ACTIONtipizzato. Il valore indica l'azione di alimentazione del sistema attualmente in corso per il computer. Per altre informazioni, vedere la sezione Osservazioni seguente.
Osservazioni
Il metodo GetSystemPowerAction consente a un driver di determinare se la transizione di alimentazione di un dispositivo si sta verificando perché il dispositivo è inattiva (o si sveglia) o perché l'intero computer sta immettendo (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 viene immettendo uno stato a basso consumo o restituendo allo stato di lavoro.
Il valore restituito 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 lavoro (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 alimentato (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 lavoro (D0) quando il driver chiama GetSystemPowerAction, mentre il resto del sistema rimane allo 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.
Esempi
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);
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.9 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |