Fonction PoSetPowerRequest (ntifs.h)
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 de demande d’alimentation 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 :
- PowerRequestSystemRequired
Valeur retournée
PoSetPowerRequest retourne STATUS_SUCCESS si l’appel réussit. Si l’appel échoue, les codes de retour d’erreur possibles sont les 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 valeurs d’énumération POWER_REQUEST_TYPE . Pour restaurer le comportement par défaut, le pilote annule la demande 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é d’un. La routine PoClearPowerRequest décrémente le nombre d’une unité. Un nombre différent de zéro indique que les demandes provenant 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 | Windows 7 |
| Plateforme cible | Universal |
| En-tête | ntifs.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |