Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Treiber können ihre Gerätehardware in mehrere logische Komponenten aufteilen, um eine differenzierte Energieverwaltung zu ermöglichen. Eine Komponente verfügt über eine Reihe von Leistungszuständen, die unabhängig von den Leistungszuständen anderer Komponenten im selben Gerät verwaltet werden können. Im F0-Zustand ist die Komponente vollständig aktiviert. Die Komponente unterstützt möglicherweise zusätzliche Energiesparzustände F1, F2 usw.
Der Besitzer der Energierichtlinie für ein Gerät ist in der Regel der Funktionstreiber des Geräts. Um die Energieverwaltung auf Komponentenebene zu aktivieren, registriert dieser Treiber das Gerät mit dem Power Management Framework (PoFx). Durch die Registrierung des Geräts übernimmt der Treiber die Verantwortung, PoFx zu informieren, wenn eine Komponente aktiv verwendet wird und wenn die Komponente im Leerlauf ist. PoFx macht intelligente Optionen für den Leerlaufzustand für das Gerät basierend auf Informationen über die Komponentenaktivität, Latenztoleranz, erwartete Leerlaufdauern und Wake-Anforderungen. Durch die Steuerung des Stromverbrauchs auf Komponentenebene kann PoFx die Energieanforderungen reduzieren und gleichzeitig die Reaktionsfähigkeit des Systems beibehalten. Weitere Informationen finden Sie unter Component-Level Power Management.
Geräte-Power Management-Routinen
Diese Routinen werden vom Power Management Framework (PoFx) implementiert, um die Gerätestromverwaltung zu ermöglichen. Diese Routinen werden vom Treiber aufgerufen, der der Besitzer der Energierichtlinie (Power Policy Owner, PPO) für ein Gerät ist. In der Regel ist der Funktionstreiber für ein Gerät das PPO für dieses Gerät.
| 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 | Die PoFxCompleteIdleState-Routine informiert das Power Management Framework (PoFx), dass die angegebene Komponente eine ausstehende Änderung an einem Fx-Zustand abgeschlossen hat. |
| 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). |
Geräte-Power Management-Rückrufe
Diese Rückrufroutinen sind vom Power Management Framework (PoFx) erforderlich, um die Energieverwaltung von Geräten zu ermöglichen. Der Treiber, der besitzer der Energierichtlinie für das Gerät ist, implementiert diese Rückrufroutinen. PoFx ruft diese Routinen auf, um die Leistungszustände der Komponenten im Gerät abzufragen und zu konfigurieren.
| 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). |
Geräte-Energieverwaltungsstrukturen
Das Power Management Framework (PoFx) definiert diese Strukturen zur Unterstützung der Gerätestromverwaltung.
| 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. |
Geräte-Power Management-Enumerationen
Das Power Management Framework (PoFx) definiert diese Enumerationen zur Unterstützung der Gerätestromverwaltung.
| 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. |
Geräte-Energieverwaltungskonstanten
PO_FX_FLAG_XXX Flagbits
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 | Nehmen Sie die Bedingungsänderung synchron vor. Wenn dieses Flag festgelegt ist, gibt die Routine, die die Bedingungsänderung anfordert, keine Kontrolle an den aufrufenden Treiber zurück, bis die Komponentenhardware den Übergang zur neuen Bedingung abgeschlossen hat. Dieses Flag kann nur verwendet werden, wenn der Aufrufer bei IRQL-DISPATCH_LEVEL < ausgeführt wird. |
| PO_FX_FLAG_ASYNC_ONLY | Nehmen Sie die Bedingungsänderung vollständig asynchron vor. Wenn dieses Flag festgelegt ist, wird die Rückrufroutine des aufrufenden Treibers von einem anderen Thread als dem Thread aufgerufen, in dem die Routine, die die Bedingungsänderung anfordert, aufgerufen wird. Daher gibt die Routine, die die Bedingungsänderung anfordert, immer asynchron zurück, ohne auf den Abschluss des Rückrufs zu warten. |
PO_FX_FLAG_XXX remarks
The Flags parameter to the following routines can be set to a PO_FX_FLAG_XXX constant:
- PoFxActivateComponent
- PoFxIdleComponent
- PoFxIssueComponentPerfStateChange
- PoFxIssueComponentPerfStateChangeMultiple
The PO_FX_FLAG_BLOCKING and PO_FX_FLAG_ASYNC_ONLY flag bits are mutually exclusive. Der Aufrufer kann ein oder das andere Flagbit im Flags-Parameter festlegen, jedoch nicht beide Flagbits.
PO_FX_FLAG_XXX Requirements
| Version | Header |
|---|---|
| Wird ab Windows 8 unterstützt. | Wdm.h |
PO_FX_FLAG_PERF_XXX Flagbits
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) | Gibt an, dass der Treiber Leistungszustände ohne Unterstützung des Plattformerweiterungs-Plug-Ins (PEP) ändern kann oder dass der Treiber Leistungszustände nur für Protokollierungszwecke bei PoFx registriert. 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) | Bei einigen Geräten muss der PEP möglicherweise einen Leistungsstatus platzieren, der für eine Komponente in einen bestimmten Leistungszustand (als nominaler Leistungszustand bezeichnet) festgelegt wird, wenn die Komponente leer ist. Treiber legen dieses Kennzeichen fest, wenn die Komponente nominale Leistungszustände enthält. In diesem Fall fragt PoFx den PEP ab, um den aktuellen Leistungsstatus zu ermitteln, wenn die Komponente zu F0 wechselt. |
| PO_FX_FLAG_PERF_QUERY_ON_ALL_IDLE_STATES | 4 (0x4) | Bei einigen Geräten muss der PEP möglicherweise einen Leistungsstatus platzieren, der für eine Komponente in einen bestimmten Leistungszustand (als nominaler Leistungszustand bezeichnet) festgelegt wird, wenn die Komponente zwischen Leerlaufzuständen wechselt. Treiber legen dieses Kennzeichen fest, wenn diese Komponente nominale Leistungszustände enthält. In diesem Fall fragt PoFx den PEP ab, um den aktuellen Leistungsstatus zu ermitteln, wenn die Komponente zwischen leerlaufstatus wechselt. |
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 |
|---|---|
| Wird ab Windows 10 unterstützt. | Wdm.h |