structure PEP_REQUEST_COMPONENT_PERF_STATE (pepfx.h)

Article
02/07/2025

La structure PEP_REQUEST_COMPONENT_PERF_STATE contient une liste des modifications de l’état des performances (P-state) demandées par l’infrastructure de gestion de l’alimentation Windows (PoFx), ainsi que des informations d’état sur la gestion de ces demandes par le plug-in d’extension de plateforme (PEP).

Syntaxe

typedef struct _PEP_REQUEST_COMPONENT_PERF_STATE {
  [in]  PEPHANDLE                         DeviceHandle;
  [in]  ULONG                             Component;
  [out] BOOLEAN                           Completed;
  [out] BOOLEAN                           Succeeded;
  [in]  ULONG                             PerfRequestsCount;
  [in]  PPEP_COMPONENT_PERF_STATE_REQUEST PerfRequests;
} PEP_REQUEST_COMPONENT_PERF_STATE, *PPEP_REQUEST_COMPONENT_PERF_STATE;

Membres

[in] DeviceHandle

Valeur PEPHANDLE qui identifie l’appareil. Le PEP a fourni ce handle en réponse à une notification PEP_DPM_REGISTER_DEVICE précédente.

[in] Component

Index qui identifie le composant. Ce membre est un index dans le tableau Components dans la structure PEP_DEVICE_REGISTER_V2 que le PEP a précédemment fourni en réponse à la notification PEP_DPM_REGISTER_DEVICE pour cet appareil. Si le tableau Composants contient N éléments, les index de composant sont comprises entre 0 et N-1.

[out] Completed

Indique si le pep a terminé les modifications d’état P demandées. Définissez la valeur TRUE pour indiquer que l’état P change de façon synchrone. Définissez la valeur FALSE pour indiquer que les modifications d’état P demandées sont en attente et seront effectuées de manière asynchrone par un thread de travail PEP. Pour plus d’informations, consultez Remarques.

[out] Succeeded

Indique si les modifications d’état P demandées ont été correctement effectuées. Définissez la valeur TRUE si le pep a correctement effectué toutes les modifications d’état P demandées dans le tableau PerfRequests tableau. Défini sur FALSE si le PEP n’a pas pu effectuer toutes les modifications d’état P demandées, auquel cas les états P dans le matériel n’ont pas été modifiés. Le membre réussi est utilisé uniquement pour modifications d’état P synchrones. Si le pep définit Terminé sur FALSE, PoFx ignore la valeur dans le membre Réussi.

[in] PerfRequestsCount

Nombre de modifications d’état P demandées dans le tableau pointé par les PerfRequests membre.

[in] PerfRequests

Pointeur vers un tableau de structures PEP_COMPONENT_PERF_STATE_REQUEST. Chaque élément du tableau spécifie un nouveau niveau de performances à affecter à un jeu d’états P. Le nombre d’éléments de tableau est spécifié par le membre PerfRequestsCount.

Remarques

Cette structure est utilisée par la notification PEP_DPM_REQUEST_COMPONENT_PERF_STATE. Le DeviceHandle, Component, PerfRequestsCountet PerfRequests membres de la structure contiennent des valeurs d’entrée fournies par PoFx lorsque cette notification est envoyée. Les terminés et membres réussis contiennent des valeurs de sortie que le PEP écrit dans la structure en réponse à la notification.

Le pep peut terminer les modifications d’état P demandées de manière synchrone ou asynchrone. Le pep peut définir le membre Terminé sur TRUE pour indiquer que toutes les demandes de la notification PEP_DPM_REQUEST_COMPONENT_PERF_STATE ont été effectuées de façon synchrone, c’est-à-dire avant le retour de la routine de rappel acceptdeviceNotification du PEP. Ou bien, le pep peut définir terminé sur FALSE pour indiquer que les demandes seront effectuées de manière asynchrone. Pour effectuer les demandes de manière asynchrone, le pep doit appeler la routine RequestWorker pour informer PoFx que le pep a une demande de travail à envoyer, et PoFx répond en envoyant une notification PEP_DPM_WORK au PEP.

PoFx écrit les modifications d’état P demandées dans le tableau PerfRequests avant l’envoi de la notification PEP_DPM_REQUEST_COMPONENT_PERF_STATE. Si le pep gère les modifications d’état P demandées de manière synchrone, le contenu du tableau PerfRequests reste valide uniquement jusqu’à ce que le retour de la routine de rappel AcceptDeviceNotification. Si les demandes sont terminées de façon asynchrone, le contenu du tableau reste valide jusqu’à ce que le pep appelle la routine [CompleteWork pour notifier PoFx que le pep a terminé les demandes en attente.