PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK fonction de rappel (wdm.h)
La routine de rappel ComponentCriticalTransitionCallback gère une transition du composant spécifié entre le F0 (entièrement activé) et les états d’alimentation des composants Xx.
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 actuel de l’alimentation 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 DeviceContext membre de la structure PO_FX_CORE_DEVICE utilisée par le pilote pour inscrire l’appareil auprès du framework de gestion de l’alimentation Windows (PoFx).
[in] Component
Index qui identifie le composant. Ce paramètre est un index dans le tableau Components dans la structure PO_FX_CORE_DEVICE utilisée par le pilote de périphérique pour inscrire l’appareil auprès de PoFx. Si le tableau Composants contient N éléments, les index de composant sont comprises entre 0 et 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 F à faible puissancex à F0. Si la valeur est FALSE, le composant est sur le point de démarrer une transition de F0 à un état de faible puissance Fx.
Valeur de retour
Aucun
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 avertir 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 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 du framework 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 actif = TRUE, PoFx a appelé cette routine après le composant a effectué une transition d’un état Fx à faible puissance vers 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 démarre une transition en attente de F0 à un état Fx à 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 Component-Levelgestion de l’alimentation .
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 10. |
| plateforme cible | Windows |
| d’en-tête | wdm.h (include Wudfwdm.h) |