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 routine PoCreatePowerRequest .
[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 non riesce, i codici restituiti di errore possibili includono quanto segue:
| Codice restituito | Descrizione |
|---|---|
| STATUS_NOT_SUPPORTED | Il parametro Type è impostato su un valore non supportato. |
Commenti
Un driver può chiamare la routine PoSetPowerRequest per richiedere che il risparmio energia sostituisci 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 routine PoClearPowerRequest .
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. La routine PoClearPowerRequest decrementa il conteggio di uno. Un conteggio diverso da zero indica che le richieste provenienti 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.
Requisiti
| 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 |