Funzione PoSetPowerRequest (ntifs.h)
La routine PoSetPowerRequest incrementa il conteggio per il tipo di richiesta di alimentazione specificato.
Sintassi
NTSTATUS PoSetPowerRequest(
[in, out] PVOID PowerRequest,
[in] POWER_REQUEST_TYPE Type
);
Parametri
[in, out] PowerRequest
Puntatore a un oggetto power request creato dalla routinepoCreatePowerRequest.
[in] Type
Tipo di richiesta di alimentazione. Impostare questo parametro sul valore di enumerazione POWER_REQUEST_TYPE seguente:
- PowerRequestSystemRequired
Valore restituito
poSetPowerRequest restituisce STATUS_SUCCESS se la chiamata ha esito positivo. Se la chiamata ha esito negativo, i codici restituiti di errore possibili includono quanto segue:
| Codice restituito | Descrizione |
|---|---|
| STATUS_NOT_SUPPORTED | Il parametro Type è impostato su un valore non supportato. |
Osservazioni
Un driver può chiamare la routine PoSetPowerRequest per richiedere che il risparmio energia eseguire l'override di diversi tipi di comportamento di alimentazione predefinito, specificati come valori di enumerazione POWER_REQUEST_TYPE. Per ripristinare il comportamento predefinito, il driver annulla la richiesta chiamando la routinepoClearPowerRequest.
Il risparmio energia gestisce un conteggio delle richieste attive per ogni tipo di richiesta di alimentazione. La routine PoSetPowerRequest incrementa il conteggio per il tipo di richiesta di alimentazione specificato di uno. Il PoClearPowerRequest decrementa il conteggio di uno. Un conteggio diverso da zero indica che le richieste da uno o più componenti sono attive. Dopo che il conteggio viene decrementato su zero, il computer ripristina il comportamento predefinito per il tipo di richiesta di alimentazione specificato.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 7 |
| piattaforma di destinazione | Universale |
| intestazione | ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |