Partager via


Fonction PoClearPowerRequest (ntifs.h)

La PoClearPowerRequest décrémente le nombre pour le type de demande d’alimentation spécifié.

Syntaxe

NTSTATUS PoClearPowerRequest(
  [in, out] PVOID              PowerRequest,
  [in]      POWER_REQUEST_TYPE Type
);

Paramètres

[in, out] PowerRequest

Pointeur vers un objet power request créé par la routine PoCreatePowerRequest.

[in] Type

Type de la demande d’alimentation. Définissez ce paramètre sur la valeur d’énumération POWER_REQUEST_TYPE suivante :

  • PowerRequestSystemRequired

Valeur de retour

PoClearPowerRequest retourne STATUS_SUCCESS si l’appel réussit. Si l’appel échoue, les codes de retour d’erreur possibles sont les suivants :

Retourner le code Description
STATUS_NOT_SUPPORTED Le paramètre Type est défini sur une valeur non prise en charge.

Remarques

Un pilote peut appeler la routine PoSetPowerRequest pour demander que le gestionnaire d’alimentation remplace plusieurs types de comportement d’alimentation par défaut, qui sont spécifiés en tant que valeurs d’énumération POWER_REQUEST_TYPE. Pour restaurer le comportement par défaut, le pilote annule la requête en appelant la routine PoClearPowerRequest.

Le gestionnaire d’alimentation gère le nombre de demandes actives pour chaque type de demande d’alimentation. La routine PoSetPowerRequest incrémente le nombre pour le type de demande d’alimentation spécifié par un. La PoClearPowerRequest décrémente le nombre par un. Un nombre différent de zéro indique que les demandes d’un ou plusieurs composants sont actives. Une fois le nombre décrémenté sur zéro, le gestionnaire d’alimentation restaure le comportement par défaut pour le type de demande d’alimentation spécifié.

Exigences

Exigence Valeur
client minimum pris en charge Windows 7
plateforme cible Universel
d’en-tête ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Voir aussi

POWER_REQUEST_TYPE

PoCreatePowerRequest

poSetPowerRequest