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 d’inactivité de la plateforme spécifié.
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) auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx). Le PEP a déjà reçu ce handle de PoFx lors de la PEP_DPM_REGISTER_DEVICE notification qui l’a informé que le sous-traitant avait été enregistré 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 le PEP a spécifié N états d’inactivité de la plateforme, les index d’état d’inactivité de la plateforme valides vont de 0 à 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 d’inactivité de la plateforme.
[in] Update
Pointeur vers une structure de PEP_PLATFORM_IDLE_STATE_UPDATE qui contient les propriétés mises à jour de l’état d’inactivité de la plateforme.
Valeur retournée
UpdatePlatformIdleState retourne STATUS_SUCCESS s’il met à jour correctement les propriétés de l’état d’inactivité de la plateforme. Les valeurs de retour d’erreur possibles incluent les codes status suivants.
| Valeur retournée | Description |
|---|---|
|
Le numéro de version dans 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 jusqu’à ce 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 à l’adresse IRQL = PASSIVE_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows 10. |
| Plateforme cible | Windows |
| En-tête | pep_x.h (include Pep_x.h) |
| IRQL | PASSIVE_LEVEL |
Voir aussi
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE