Funzione PoClearPowerRequest (ntifs.h)
La routine 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 routine PoCreatePowerRequest .
[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. |
Commenti
Un driver può chiamare la routine PoSetPowerRequest per richiedere che il power manager esegue l'override di diversi tipi di comportamento di alimentazione predefinito, che vengono specificati come valori di enumerazione POWER_REQUEST_TYPE . Per ripristinare il comportamento predefinito, il driver annulla la richiesta chiamando la routine PoClearPowerRequest .
Power Manager 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 per uno. La routine PoClearPowerRequest decrementa il conteggio per uno. Un conteggio diverso da zero indica che le richieste da uno o più componenti sono attive. Dopo il conteggio decrementa su zero, power manager 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 |