Fonction PoSetPowerRequest (wdm.h)

  • Article

La routine PoSetPowerRequest incrémente le nombre pour le type de demande d’alimentation spécifié.

Syntaxe

NTSTATUS PoSetPowerRequest(
  [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 demande d’alimentation. Définissez ce paramètre sur la valeur d’énumération POWER_REQUEST_TYPE suivante :

  • PowerRequestSystemRequiredred

Valeur retournée

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

Code de retour 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 comme POWER_REQUEST_TYPE valeurs d’énumération . Pour restaurer le comportement par défaut, le pilote annule la demande en appelant la routine PoClearPowerRequest .

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 7.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Voir aussi

POWER_REQUEST_TYPE

PoClearPowerRequest

PoCreatePowerRequest