PO_FX_COMPONENT_PERF_STATE_CALLBACK fonction de rappel (wdm.h)

Article
02/29/2024

La routine de rappel ComponentPerfStateCallback avertit le pilote que sa demande de modification de l’état des performances d’un composant est terminée.

Syntaxe

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

Paramètres

[in] Context

Pointeur vers le contexte de l’appareil. Le pilote de périphérique utilise ce contexte pour stocker des informations sur l’état d’alimentation actuel de l’appareil. Le pilote de périphérique a spécifié ce pointeur dans le membre DeviceContext de la structure PO_FX_DEVICE que le pilote a utilisée pour inscrire l’appareil auprès de l’infrastructure de gestion de l’alimentation (PoFx). Ce contexte est opaque pour PoFx.

[in] Component

Spécifie l’index qui identifie le composant. Ce paramètre est un index dans le tableau Components de la structure PO_FX_DEVICE que le pilote de périphérique a utilisé pour inscrire l’appareil auprès de PoFx. Si le tableau Composants contient N éléments, les index des composants vont de 0 à N–1.

[in] Succeeded

Si la valeur est TRUE, le plug-in d’extension de plateforme (PEP) a réussi le changement d’état des performances. Si la valeur est FALSE, le PEP n’a pas réussi à modifier l’état des performances. Pour plus d'informations, consultez la section Notes.

[in] RequestContext

Pointeur vers le pilote ou le contexte d’appareil facultatif spécifié par le paramètre Context de la routine PoFxIssueComponentPerfStateChange ou PoFxIssueComponentPerfStateChangeMultiple .

Valeur de retour

None

Remarques

Lorsqu’un pilote d’appareil demande un changement d’état des performances en appelant la routine PoFxIssueComponentPerfStateChange ou PoFxIssueComponentPerfStateChangeMultiple , PoFx appelle la routine ComponentPerfStateCallback pour avertir le pilote lorsque la demande est terminée.

Pour spécifier une routine ComponentPerfStateCallback , utilisez le paramètre ComponentPerfStateCallback de la routine PoFxRegisterComponentPerfStates lorsque le pilote s’inscrit à la gestion de l’état des performances par PoFx. La routine ComponentPerfStateCallback peut être la même pour tous les composants et tous les appareils.

Si Réussite est TRUE, le pilote doit effectuer le travail nécessaire pour modifier l’état des performances dans le matériel. Si Réussi est FALSE, le pilote peut choisir de ne rien faire ou de réessayer la requête avec le même état de performances ou un autre état de performances.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 10.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdm.h
IRQL	Appelé à IRQL <= DISPATCH_LEVEL.

Voir aussi

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice

Partager via