Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Stuurprogramma's kunnen hun apparaathardware in meerdere logische onderdelen verdelen om fijnmazig energiebeheer mogelijk te maken. Een onderdeel heeft een reeks energiestatussen die onafhankelijk van de energiestatussen van andere onderdelen in hetzelfde apparaat kunnen worden beheerd. In de F0-status is het onderdeel volledig ingeschakeld. Het onderdeel ondersteunt mogelijk aanvullende statussen met weinig vermogen F1, F2, enzovoort.
De eigenaar van het energiebeleid voor een apparaat is doorgaans het functiestuurprogramma van het apparaat. Als u energiebeheer op onderdeelniveau wilt inschakelen, registreert dit stuurprogramma het apparaat met het Energiebeheerframework (PoFx). Door het apparaat te registreren, neemt het stuurprogramma de verantwoordelijkheid voor het informeren van PoFx wanneer een onderdeel actief wordt gebruikt en wanneer het onderdeel niet actief is. PoFx maakt intelligente inactieve statuskeuzes voor het apparaat op basis van informatie over de activiteit van onderdelen, latentietolerantie, verwachte inactiviteitsduur en wake-vereisten. Door het energieverbruik op onderdeelniveau te beheren, kan PoFx de energievereisten verminderen terwijl de reactiesnelheid van het systeem behouden blijft. Zie Component-Level Energiebeheer voor meer informatie.
Routines voor apparaatbeheer
Deze routines worden geïmplementeerd door het energiebeheerframework (PoFx) om energiebeheer van apparaten mogelijk te maken. Deze routines worden aangeroepen door de bestuurder die de eigenaar van het energiebeleid (OPGEGEVEN) is voor een apparaat. Normaal gesproken is het functiestuurprogramma voor een apparaat de OPGEGEVEN voor dit apparaat.
| 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 | De Routine PoFxCompleteIdleState informeert het energiebeheerframework (PoFx) dat het opgegeven onderdeel een wijziging in behandeling heeft voltooid in een Fx-status. |
| 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). |
Callbacks voor apparaatbeheer
Deze callback-routines zijn vereist voor het energiebeheerframework (PoFx) om energiebeheer van apparaten mogelijk te maken. Het stuurprogramma dat de eigenaar van het energiebeleid voor het apparaat is, implementeert deze callback-routines. PoFx roept deze routines aan om de energiestatussen van de onderdelen in het apparaat op te vragen en te configureren.
| 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). |
Apparaatbeheerstructuren
Het energiebeheerframework (PoFx) definieert deze structuren ter ondersteuning van energiebeheer van apparaten.
| 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. |
Opsommingen voor energiebeheer van apparaten
Het energiebeheerframework (PoFx) definieert deze opsommingen ter ondersteuning van energiebeheer van apparaten.
| 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. |
Constanten voor apparaatbeheer
PO_FX_FLAG_XXX vlag bits
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 | Breng de voorwaarde synchroon aan. Als deze vlag is ingesteld, retourneert de routine die de voorwaardewijziging aanvraagt, geen controle over het aanroepende stuurprogramma totdat de hardware van het onderdeel de overgang naar de nieuwe voorwaarde voltooit. Deze vlag kan alleen worden gebruikt als de aanroeper wordt uitgevoerd op IRQL < DISPATCH_LEVEL. |
| PO_FX_FLAG_ASYNC_ONLY | Breng de voorwaarde volledig asynchroon aan. Als deze vlag is ingesteld, wordt de callbackroutine van het aanroepende stuurprogramma aangeroepen vanuit een andere thread dan de thread waarin de routine die de voorwaardewijziging aanvraagt, wordt aangeroepen. De routine die de voorwaardewijziging aanvraagt, retourneert dus altijd asynchroon zonder te wachten tot de callback is voltooid. |
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. De aanroeper kan een of de andere vlag-bit instellen in de parameter Flags, maar niet beide vlag-bits.
PO_FX_FLAG_XXX Requirements
| Version | Header |
|---|---|
| Ondersteund vanaf Windows 8. | Wdm.h |
PO_FX_FLAG_PERF_XXX vlag bits
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) | Geeft aan dat het stuurprogramma prestatiestatussen kan wijzigen zonder hulp van de invoegtoepassing voor platformuitbreidingen (PEP), of dat het stuurprogramma alleen prestatiestatussen registreert bij PoFx voor logboekregistratiedoeleinden. 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) | Voor sommige apparaten moet het PEP mogelijk een prestatiestatus voor een onderdeel in een bepaalde prestatiestatus (ook wel nominale prestatiestatus genoemd) plaatsen wanneer het onderdeel inactief is. Stuurprogramma's stellen deze vlag in als het onderdeel nominale prestatiestatussen bevat. In dat geval voert PoFx een query uit op het PEP om de huidige prestatiestatus te bepalen wanneer het onderdeel overgaat naar F0. |
| PO_FX_FLAG_PERF_QUERY_ON_ALL_IDLE_STATES | 4 (0x4) | Voor sommige apparaten moet het PEP mogelijk een prestatiestatus voor een onderdeel in een bepaalde prestatiestatus (ook wel nominale prestatiestatus genoemd) plaatsen wanneer het het onderdeel overgaat tussen niet-actieve toestanden. Stuurprogramma's stellen deze vlag in als dit onderdeel nominale prestatiestatussen bevat. In dat geval voert PoFx een query uit op het PEP om de huidige prestatiestatus te bepalen wanneer het onderdeel overgaat tussen niet-actieve statussen. |
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 |
|---|---|
| Ondersteund vanaf Windows 10. | Wdm.h |