Fonction de rappel POFXCALLBACKUPDATEPLATFORMIDLESTATE (pep_x.h)

  • Article

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
STATUS_NOT_SUPPORTED
 Le numéro de version dans la structure PEP_PLATFORM_IDLE_STATE_UPDATE n’est pas une valeur prise en charge.
STATUS_NOT_IMPLEMENTED
 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_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE