PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK fonction de rappel (wdm.h)

  • Article

La routine de rappel ComponentCriticalTransitionCallback gère une transition du composant spécifié entre les états d’alimentation du composant F0 (entièrement activé) et fx de faible puissance.

Syntaxe

PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;

void PoFxComponentCriticalTransitionCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Active
)
{...}

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. Ce contexte est défini par le pilote et est opaque pour PoFx. Le pilote a spécifié ce pointeur dans le membre DeviceContext de la structure PO_FX_CORE_DEVICE que le pilote a utilisée pour inscrire l’appareil auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx).

[in] Component

Index qui identifie le composant. Ce paramètre est un index dans le tableau Composants de la structure PO_FX_CORE_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] Active

Indique si cette notification concerne une transition vers l’état d’alimentation du composant F0. Si la valeur EST TRUE, le composant vient d’effectuer une transition d’un état Fx basse consommation à F0. Si la valeur est FALSE, le composant est sur le point de démarrer une transition de F0 à un état Fx de faible puissance.

Valeur de retour

None

Remarques

Cette routine de rappel est implémentée par un pilote de périphérique et est appelée par PoFx. PoFx appelle cette routine pour informer le pilote des transitions d’alimentation des composants de l’appareil.

Le membre ComponentCriticalTransitionCallback de la structure PO_FX_CORE_DEVICE est un pointeur vers une routine de rappel ComponentCriticalTransitionCallback . Un pointeur vers une structure de PO_FX_CORE_DEVICE est passé en tant que paramètre d’entrée dans l’appel PoFxRegisterCoreDevice qui inscrit un appareil principal auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx).

Pour gérer les appels à cette routine, le pilote de périphérique enregistre ou restaure l’état du registre ou un autre contexte matériel du composant spécifié dans l’appareil.

Si Active = TRUE, PoFx a appelé cette routine après que le composant a terminé une transition d’un état Fx basse consommation à F0. Dans cet appel, la routine restaure le contexte matériel précédemment enregistré du composant.

Si Actif = FALSE, PoFx a appelé cette routine avant que le composant ne démarre une transition en attente de F0 vers un état Fx de faible puissance. Dans cet appel, la routine enregistre le contexte matériel du composant afin que ce contexte puisse être restauré ultérieurement.

Pour plus d’informations sur les états d’alimentation des composants Fx , consultez Gestion de l’alimentation au niveau des composants.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge à partir de Windows 10.
Plateforme cible Windows
En-tête wdm.h (inclure Wudfwdm.h)

Voir aussi

PO_FX_CORE_DEVICE