Partager via

Informations de référence sur la gestion de l’alimentation des appareils

Les pilotes peuvent diviser leur matériel de périphérique en plusieurs composants logiques pour permettre la gestion de l’alimentation affinée. Un composant a un ensemble d’états d’alimentation qui peuvent être gérés indépendamment des états d’alimentation d’autres composants dans le même appareil. Dans l’état F0, le composant est entièrement activé. Le composant peut prendre en charge des états F1, F2 et ainsi de suite supplémentaires.

Le propriétaire de la stratégie d’alimentation d’un appareil est généralement le pilote de fonction de l’appareil. Pour activer la gestion de l’alimentation au niveau du composant, ce pilote inscrit l’appareil auprès de l’infrastructure de gestion de l’alimentation (PoFx). En inscrivant l’appareil, le pilote assume la responsabilité d’informer PoFx lorsqu’un composant est utilisé activement et quand le composant est inactif. PoFx fait des choix d’état d’inactivité intelligents pour l’appareil en fonction des informations sur l’activité des composants, la tolérance de latence, les durées d’inactivité attendues et les exigences de mise en éveil. En contrôlant l’utilisation de l’alimentation au niveau du composant, PoFx peut réduire les exigences d’alimentation tout en préservant la réactivité du système. Pour plus d’informations, consultez Component-Level Gestion de l’alimentation.

Routines de gestion de l’alimentation des appareils

Ces routines sont implémentées par l’infrastructure de gestion de l’alimentation (PoFx) pour activer la gestion de l’alimentation des appareils. Ces routines sont appelées par le pilote qui est le propriétaire de la stratégie d’alimentation (PPO) d’un appareil. En règle générale, le pilote de fonction d’un appareil est l’objet PPO de cet appareil.

Topic Description
PoFxActivateComponent The PoFxActivateComponent routine increments the activation reference count on the specified component.
PoFxCompleteDevicePowerNotRequired The PoFxCompleteDevicePowerNotRequired routine notifies the power management framework (PoFx) that the calling driver has completed its response to a call to the driver's DevicePowerNotRequiredCallback callback routine.
PoFxCompleteIdleCondition The PoFxCompleteIdleCondition routine informs the power management framework (PoFx) that the specified component has completed a pending change to the idle condition.
PoFxCompleteIdleState La routine PoFxCompleteIdleState informe le framework de gestion de l’alimentation (PoFx) que le composant spécifié a terminé une modification en attente d’un état Fx.
PoFxIdleComponent The PoFxIdleComponent routine decrements the activation reference count on the specified component.
PoFxIssueComponentPerfStateChange The PoFxIssueComponentPerfStateChange routine submits a request to place a device component in a particular performance state.
PoFxIssueComponentPerfStateChangeMultiple The PoFxIssueComponentPerfStateChangeMultiple routine submits a request to change the performance states in multiple performance state sets simultaneously for a device component.
PoFxNotifySurprisePowerOn The PoFxNotifySurprisePowerOn routine notifies the power management framework (PoFx) that a device was turned on as a side effect of supplying power to some other device.
PoFxPowerControl The PoFxPowerControl routine sends a power control request to the power management framework (PoFx).
PoFxQueryCurrentComponentPerfState The PoFxQueryCurrentComponentPerfState routine retrieves the active performance state in a component's performance state set.
PoFxRegisterComponentPerfStates The PoFxRegisterComponentPerfStates routine registers a device component for performance state management by the power management framework (PoFx).
PoFxRegisterDevice The PoFxRegisterDevice routine registers a device with the power management framework (PoFx).
PoFxReportDevicePoweredOn The PoFxReportDevicePoweredOn routine notifies the power management framework (PoFx) that the device completed the requested transition to the D0 (fully on) power state.
PoFxSetComponentLatency The PoFxSetComponentLatency routine specifies the maximum latency that can be tolerated in the transition from the idle condition to the active condition in the specified component.
PoFxSetComponentResidency The PoFxSetComponentResidency routine sets the estimated time for how long a component is likely to remain idle after the component enters the idle condition.
PoFxSetComponentWake The PoFxSetComponentWake routine indicates whether the driver arms the specified component to wake whenever the component enters the idle condition.
PoFxSetDeviceIdleTimeout The PoFxSetDeviceIdleTimeout routine specifies the minimum time interval from when the last component of the device enters the idle condition to when the power management framework (PoFx) calls the driver's DevicePowerNotRequiredCallback callback routine.
PoFxStartDevicePowerManagement The PoFxStartDevicePowerManagement routine completes the registration of a device with the power management framework (PoFx) and starts device power management.
PoFxUnregisterDevice The PoFxUnregisterDevice routine removes the registration of a device from the power management framework (PoFx).

Rappels de gestion de l’alimentation des appareils

Ces routines de rappel sont requises par l’infrastructure de gestion de l’alimentation (PoFx) pour activer la gestion de l’alimentation des appareils. Le pilote qui est le propriétaire de la stratégie d’alimentation de l’appareil implémente ces routines de rappel. PoFx appelle ces routines pour interroger et configurer les états d’alimentation des composants de l’appareil.

Topic Description
ComponentActiveConditionCallback The ComponentActiveConditionCallback callback routine notifies the driver that the specified component completed a transition from the idle condition to the active condition.
ComponentIdleConditionCallback The ComponentIdleConditionCallback callback routine notifies the driver that the specified component completed a transition from the active condition to the idle condition.
ComponentIdleStateCallback The ComponentIdleStateCallback callback routine notifies the driver of a pending change to the Fx power state of the specified component.
ComponentPerfStateCallback The ComponentPerfStateCallback callback routine notifies the driver that its request to change the performance state of a component is complete.
DevicePowerNotRequiredCallback The DevicePowerNotRequiredCallback callback routine notifies the device driver that the device is not required to stay in the D0 power state.
DevicePowerRequiredCallback The DevicePowerRequiredCallback callback routine notifies the device driver that the device must enter and remain in the D0 power state.
PowerControlCallback The PowerControlCallback callback routine performs a power control operation that is requested by the power management framework (PoFx).

Structures de gestion de l’alimentation des appareils

Le framework de gestion de l’alimentation (PoFx) définit ces structures pour prendre en charge la gestion de l’alimentation des appareils.

Topic Description
PO_FX_COMPONENT_V1PO_FX_COMPONENT_V2 The PO_FX_COMPONENT structure describes the power state attributes of a component in a device.
PO_FX_COMPONENT_IDLE_STATE The PO_FX_COMPONENT_IDLE_STATE structure specifies the attributes of an Fx power state of a component in a device.
PO_FX_COMPONENT_PERF_INFO The PO_FX_COMPONENT_PERF_INFO structure describes all the sets of performance states for a single component within a device.
PO_FX_COMPONENT_PERF_SET The PO_FX_COMPONENT_PERF_SET structure represents a set of performance states for a single component within a device.
PO_FX_DEVICE_V1PO_FX_DEVICE_V2PO_FX_DEVICE_V3 The PO_FX_DEVICE structure describes the power attributes of a device to the power management framework (PoFx).
PO_FX_PERF_STATE The PO_FX_PERF_STATE structure represents a performance state for a single component within a device.
PO_FX_PERF_STATE_CHANGE The PO_FX_PERF_STATE_CHANGE structure contains information about a change to a performance state that is being requested by calling the PoFxIssueComponentPerfStateChange or PoFxIssueComponentPerfStateChangeMultiple routine.

Énumérations de gestion de l’alimentation des appareils

Le framework de gestion de l’alimentation (PoFx) définit ces énumérations pour prendre en charge la gestion de l’alimentation des appareils.

Topic Description
PO_FX_PERF_STATE_TYPE The PO_FX_PERF_STATE_TYPE enumeration contains values that describe the type of performance states in a PO_FX_COMPONENT_PERF_SET.
PO_FX_PERF_STATE_UNIT The PO_FX_PERF_STATE_UNIT enumeration contains values that describe the type of unit that is controlled by the performance states in a PO_FX_COMPONENT_PERF_SET.

Constantes de gestion de l’alimentation des appareils

PO_FX_FLAG_XXX bits d’indicateur

The PO_FX_FLAG_XXX constants are flag bits that indicate whether a request to change the condition of component is performed synchronously or asynchronously.

#define PO_FX_FLAG_BLOCKING   0x1
#define PO_FX_FLAG_ASYNC_ONLY 0x2

PO_FX_FLAG_XXX constants

Constant Description
PO_FX_FLAG_BLOCKING Modifiez la condition de façon synchrone. Si cet indicateur est défini, la routine qui demande la modification de la condition ne retourne pas le contrôle au pilote appelant tant que le matériel du composant n’a pas terminé la transition vers la nouvelle condition. Cet indicateur ne peut être utilisé que si l’appelant s’exécute à l’DISPATCH_LEVEL IRQL < .
PO_FX_FLAG_ASYNC_ONLY Modifiez complètement la condition de façon asynchrone. Si cet indicateur est défini, la routine de rappel du pilote appelant est appelée à partir d’un thread autre que le thread dans lequel la routine qui demande la modification de la condition est appelée. Ainsi, la routine qui demande la modification de la condition retourne toujours de façon asynchrone sans attendre que le rappel se termine.

PO_FX_FLAG_XXX remarks

The Flags parameter to the following routines can be set to a PO_FX_FLAG_XXX constant:

The PO_FX_FLAG_BLOCKING and PO_FX_FLAG_ASYNC_ONLY flag bits are mutually exclusive. L’appelant peut définir un ou l’autre bit d’indicateur dans le paramètre Indicateurs, mais pas les deux bits d’indicateur.

PO_FX_FLAG_XXX Requirements

Version Header
Prise en charge à partir de Windows 8. Wdm.h

PO_FX_FLAG_PERF_XXX bits d’indicateur

The PO_FX_FLAG_PERF_XXX constants are flag bits that define how the power management framework (PoFx) manages performance states for a device component.

#define PO_FX_FLAG_PERF_PEP_OPTIONAL   0x1
#define PO_FX_FLAG_PERF_QUERY_ON_F0 0x2
#define PO_FX_FLAG_PERF_QUERY_ON_ALL_IDLE_STATES 0x4
Constant Value Description
PO_FX_FLAG_PERF_PEP_OPTIONAL 1 (0x1) Indique que le pilote peut modifier les états de performances sans assistance du plug-in d’extension de plateforme (PEP) ou que le pilote inscrit des états de performances auprès de PoFx à des fins de journalisation uniquement. If this flag is set, the PoFxRegisterComponentPerfStates call will still succeeded if the PEP does not support performance states for the component.
PO_FX_FLAG_PERF_QUERY_ON_F0 2 (0x2) Pour certains appareils, le pep peut avoir besoin d’un emplacement d’état de performances défini pour un composant dans un état de performances spécifique (appelé état de performances nominal) lorsqu’il inactif le composant. Les pilotes définissent cet indicateur si le composant contient des états de performances nominals, auquel cas PoFx interroge le pep pour déterminer l’état actuel des performances lorsque le composant passe à F0.
PO_FX_FLAG_PERF_QUERY_ON_ALL_IDLE_STATES 4 (0x4) Pour certains appareils, le pep peut avoir besoin d’un emplacement d’état de performances défini pour un composant dans un état de performances spécifique (appelé état de performances nominal) lorsqu’il passe le composant entre les états inactifs. Les pilotes définissent cet indicateur si ce composant contient des états de performances nominals, auquel cas PoFx interroge le pep pour déterminer l’état actuel des performances lorsque le composant passe entre les états inactifs.

PO_FX_FLAG_PERF_XXX remarks

The Flags parameter to the PoFxRegisterComponentPerfStates routine can be set to a PO_FX_FLAG_PERF_XXX constant.

PO_FX_FLAG_PERF_XXX requirements

Requirements Version
Prise en charge à partir de Windows 10. Wdm.h
  • Last updated on