Funzione PoClearPowerRequest (ntifs.h)
La PoClearPowerRequest decrementa il conteggio per il tipo di richiesta di alimentazione specificato.
Sintassi
NTSTATUS PoClearPowerRequest(
[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 della richiesta di alimentazione. Impostare questo parametro sul valore di enumerazione POWER_REQUEST_TYPE seguente:
- PowerRequestSystemRequired
Valore restituito
PoClearPowerRequest 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 routinePoSetPowerRequest 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. 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 risparmio energia 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 |