Funzione PoSetSystemState (wdm.h)
I driver chiamano la routine PoSetSystemState per indicare che il sistema è attivo.
Sintassi
void PoSetSystemState(
[in] EXECUTION_STATE Flags
);
Parametri
[in] Flags
Indica l'attività di sistema, come specificato da un OR bit per bit di uno o più dei valori seguenti:
ES_SYSTEM_REQUIRED
Il sistema non è inattiva, indipendentemente dal carico apparente.
ES_DISPLAY_REQUIRED
È necessario usare lo schermo.
ES_USER_PRESENT
È presente un utente.
Valore restituito
nessuno
Osservazioni
Un driver chiama PoSetSystemState per impostare i flag che indicano che si sta verificando l'attività di sistema. A differenza di PoRegisterSystemState, questa routine non consente al driver di impostare uno stato occupato persistente.
Il parametro Flags specifica il tipo di attività in corso. I driver possono specificare qualsiasi combinazione dei flag.
I driver possono impostare lo stato occupato dal sistema per richiedere che il sistema eviti di uscire dallo stato di lavoro durante l'esecuzione dell'attività del driver. Si noti, tuttavia, che in alcune circostanze ,ad esempio una batteria a basso consumo critico, il gestore di alimentazione può sostituire questa richiesta e mettere il sistema in sospensione comunque.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <=DISPATCH_LEVEL |