Fonction de rappel POFXCALLBACKUPDATEPLATFORMIDLESTATE (pep_x.h)
La routine updatePlatformIdleState est appelée par le plug-in d’extension de plateforme (PEP) pour mettre à jour les propriétés de l’état inactif de la plateforme spécifiée.
Syntaxe
POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;
NTSTATUS Pofxcallbackupdateplatformidlestate(
[in] POHANDLE ProcessorHandle,
[in] ULONG PlatformState,
[in] PPEP_PLATFORM_IDLE_STATE_UPDATE Update
)
{...}
Paramètres
[in] ProcessorHandle
Valeur POHANDLE qui représente l’inscription du processeur (en tant qu’appareil) avec l’infrastructure de gestion de l’alimentation Windows (PoFx). Le PEP a reçu précédemment ce handle de PoFx pendant la notification PEP_DPM_REGISTER_DEVICE qui a informé le PEP que le processeur avait été inscrit auprès de PoFx.
[in] PlatformState
Index qui identifie l’état inactif de la plateforme dont les propriétés doivent être mises à jour. En réponse à une notification PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES précédente, le PEP a spécifié le nombre d’états inactifs de plateforme pris en charge. Si les états inactifs de la plateforme PEP spécifiés, les index d’état d’inactivité de la plateforme valides sont comprises entre 0 et N-1. En réponse à une notification PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE précédente, le pep a spécifié les propriétés de cet état inactif de plateforme.
[in] Update
Pointeur vers une structure PEP_PLATFORM_IDLE_STATE_UPDATE qui contient les propriétés mises à jour de l’état inactif de la plateforme.
Valeur de retour
UpdatePlatformIdleState retourne STATUS_SUCCESS si elle met à jour correctement les propriétés de l’état inactif de la plateforme. Les valeurs de retour d’erreur possibles incluent les codes d’état suivants.
| Valeur de retour | Description |
|---|---|
|
Le numéro de version de la structure PEP_PLATFORM_IDLE_STATE_UPDATE n’est pas une valeur prise en charge. |
|
La routine UpdatePlatformIdleState n’est pas implémentée pour ce processeur. |
Remarques
Cette routine est implémentée par PoFx et est appelée par le PEP. Le membre UpdatePlatformIdleState de la structure PEP_KERNEL_INFORMATION_STRUCT_V3 est un pointeur vers une routine UpdatePlatformIdleState.
Le pep doit attendre qu’il ait terminé toutes les notifications PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE pour appeler la routine UpdatePlatformIdleState.
La routine UpdatePlatformIdleState doit être appelée à IRQL = PASSIVE_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 10. |
| plateforme cible | Windows |
| d’en-tête | pep_x.h (inclure Pep_x.h) |
| IRQL | PASSIVE_LEVEL |
Voir aussi
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE