PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK Rückruffunktion (wdm.h)

  • Artikel

Die Rückrufroutine ComponentCriticalTransitionCallback verarbeitet einen Übergang der angegebenen Komponente zwischen dem Energiezustand F0 (vollständig aktiviert) und Fx-Komponenten mit niedriger Leistung.

Syntax

PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;

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

Parameter

[in] Context

Ein Zeiger auf den Gerätekontext. Der Gerätetreiber verwendet diesen Kontext, um Informationen zum aktuellen Energiezustand des Geräts zu speichern. Dieser Kontext ist treiberdefiniert und für PoFx undurchsichtig. Der Treiber hat diesen Zeiger im DeviceContext-Member der PO_FX_CORE_DEVICE-Struktur angegeben, mit der der Treiber das Gerät beim Windows Power Management Framework (PoFx) registriert hat.

[in] Component

Der Index, der die Komponente identifiziert. Dieser Parameter ist ein Index im Array Components in der PO_FX_CORE_DEVICE-Struktur , die der Gerätetreiber zum Registrieren des Geräts bei PoFx verwendet hat. Wenn das Komponentenarray N-Elemente enthält, reichen die Komponentenindizes von 0 bis N–1.

[in] Active

Gibt an, ob diese Benachrichtigung für einen Übergang zum Energiezustand der F0-Komponente vorgesehen ist. Bei TRUE hat die Komponente gerade einen Übergang von einem Low-Power-Fx-Zustand zu F0 abgeschlossen. Bei FALSE beginnt die Komponente mit dem Übergang von F0 zu einem Fx-Zustand mit geringem Stromverbrauch.

Rückgabewert

Keine

Bemerkungen

Diese Rückrufroutine wird von einem Gerätetreiber implementiert und von PoFx aufgerufen. PoFx ruft diese Routine auf, um den Treiber über Energieübergänge von Gerätekomponenten zu benachrichtigen.

Das ComponentCriticalTransitionCallback-Element der PO_FX_CORE_DEVICE-Struktur ist ein Zeiger auf eine ComponentCriticalTransitionCallback-Rückrufroutine . Ein Zeiger auf eine PO_FX_CORE_DEVICE-Struktur wird als Eingabeparameter im PoFxRegisterCoreDevice-Aufruf übergeben, der ein Kerngerät beim Windows Power Management Framework (PoFx) registriert.

Um Aufrufe dieser Routine zu verarbeiten, speichert oder stellt der Gerätetreiber den Registerzustand oder einen anderen Hardwarekontext der angegebenen Komponente auf dem Gerät wieder her.

Wenn Aktiv = TRUE, hat PoFx diese Routine aufgerufen, nachdem die Komponente einen Übergang von einem Low-Power-Fx-Zustand zu F0 abgeschlossen hat. In diesem Aufruf stellt die Routine den zuvor gespeicherten Hardwarekontext der Komponente wieder her.

Wenn Aktiv = FALSE, hat PoFx diese Routine aufgerufen, bevor die Komponente einen ausstehenden Übergang von F0 zu einem Fx-Zustand mit geringem Stromverbrauch startet. Bei diesem Aufruf speichert die Routine den Hardwarekontext der Komponente, sodass dieser Kontext später wiederhergestellt werden kann.

Weitere Informationen zu den Energiezuständen von Fx-Komponenten finden Sie unter Energieverwaltung auf Komponentenebene.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt ab Windows 10.
Zielplattform Windows
Kopfzeile wdm.h (include Wudfwdm.h)

Weitere Informationen

PO_FX_CORE_DEVICE