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

Vedi anche

POWER_REQUEST_TYPE

PoCreatePowerRequest

PoSetPowerRequest