PEP_NOTIFY_COMPONENT_IDLE_STATE Struktur (pep_x.h)

Artikel
02/07/2025

Die PEP_NOTIFY_COMPONENT_IDLE_STATE-Struktur enthält Statusinformationen zum ausstehenden Übergang einer Komponente zu einem neuen Fx Energiezustand.

Syntax

typedef struct _PEP_NOTIFY_COMPONENT_IDLE_STATE {
  [in]  PEPHANDLE DeviceHandle;
  [in]  ULONG     Component;
  [in]  ULONG     IdleState;
  [in]  BOOLEAN   DriverNotified;
  [out] BOOLEAN   Completed;
} PEP_NOTIFY_COMPONENT_IDLE_STATE, *PPEP_NOTIFY_COMPONENT_IDLE_STATE;

Angehörige

[in] DeviceHandle

Ein PEPHANDLE-Wert, der das Gerät identifiziert. Der PEP hat dieses Handle als Reaktion auf eine vorherige PEP_DPM_REGISTER_DEVICE Benachrichtigung bereitgestellt.

[in] Component

Der Index, der die Komponente identifiziert. Dieses Element ist ein Index im Components Array in der PEP_DEVICE_REGISTER_V2 Struktur, die der PEP zuvor als Reaktion auf die PEP_DPM_REGISTER_DEVICE-Benachrichtigung für dieses Gerät bereitgestellt hat. Wenn das Components Array N-Elemente enthält, reichen Komponentenindizes von 0 bis N-1.

[in] IdleState

Der neue Fx Leistungszustand, zu dem die Komponente wechselt. Wenn dieser Parameter null ist, lautet der neue Zustand F0; wenn dieser Parameter eins ist, lautet der neue Zustand F1; Und so weiter.

[in] DriverNotified

Gibt an, ob der Treiber für das Gerät bereits über den ausstehenden Übergang zum neuen Fx Zustand benachrichtigt wurde. Wenn TRUE, hat das Power Management Framework (PoFx) den Treiber bereits durch Aufrufen der ComponentIdleStateCallback Rückrufroutine des Treibers benachrichtigt. Wenn FALSE, hat PoFx den Treiber noch nicht benachrichtigt.

[out] Completed

Ob der PEP alle notwendigen Vorbereitungen für die angegebene Komponente abgeschlossen hat, um in den neuen Fx Zustand einzusteigen. Auf TRUE festgelegt, um anzugeben, dass der PEP alle erforderlichen Vorbereitungen abgeschlossen hat, oder auf FALSE, um anzugeben, dass dies nicht der Fall ist.

Wenn FALSCH, muss der PEP die notwendigen Vorbereitungen zu einem späteren Zeitpunkt abschließen und dann PoFx informieren, wann die Vorbereitungen abgeschlossen wurden. Dazu ruft der PEP die RequestWorker Routine auf, um eine Arbeitsaufgabe anzufordern, und antwortet dann auf die resultierende PEP_DPM_WORK Benachrichtigung, indem eine Arbeitsanfrage vom Typ PepWorkCompleteIdleState übermittelt wird, um PoFx darüber zu informieren, dass die Vorbereitungen abgeschlossen sind.

Bemerkungen

Diese Struktur wird von der PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE-Benachrichtigung verwendet. Die ersten vier Elemente dieser Struktur enthalten Eingabewerte, die von PoFx bereitgestellt werden. Das element Abgeschlossen enthält einen Ausgabewert, den der PEP als Reaktion auf diese Benachrichtigung in die Struktur schreibt.