PEP_PPM_IDLE_SELECT-Struktur (pep_x.h)

Artikel
03/01/2024

Die PEP_PPM_IDLE_SELECT-Struktur beschreibt den energieeffizientesten Leerlaufzustand, den der Prozessor eingeben kann und weiterhin die vom Betriebssystem angegebenen Einschränkungen erfüllen kann.

Syntax

typedef struct _PEP_PPM_IDLE_SELECT {
  [in]  PPEP_PROCESSOR_IDLE_CONSTRAINTS Constraints;
  [out] BOOLEAN                         AbortTransition;
  [out] ULONG                           IdleStateIndex;
  [out] ULONG                           DependencyArrayUsed;
  [in]  ULONG                           DependencyArrayCount;
  [in]  PPEP_PROCESSOR_IDLE_DEPENDENCY  DependencyArray;
  [out] ULONG                           PlatformIdleStateIndex;
} PEP_PPM_IDLE_SELECT, *PPEP_PPM_IDLE_SELECT;

Member

[in] Constraints

Ein Zeiger auf eine PEP_PROCESSOR_IDLE_CONSTRAINTS-Struktur , die die Einschränkungen angibt, die der ausgewählte Prozessor-Leerlaufzustand erfüllen muss. Das Betriebssystem legt die Werte in dieser Struktur fest. Das Plattformerweiterungs-Plug-In (PEP) muss einen Prozessor-Leerlaufzustand auswählen, der diese Einschränkungen erfüllt.

[out] AbortTransition

Gibt an, ob der ausstehende Übergang zu einem Prozessor-Leerlaufzustand abgebrochen werden soll. Legen Sie diesen Member auf TRUE fest, wenn pep erfordert, dass das Betriebssystem den ausstehenden Übergang abbrechen muss, und andernfalls auf FALSE. Pep wählt diese Option aus, wenn die Arbeit in die Warteschlange gestellt werden soll und der Windows-Kernel diese Arbeit verarbeitet, bevor der Prozessor in den Leerlauf wechselt.

[out] IdleStateIndex

Der Index, der den Leerlaufzustand identifiziert, den der Prozessor eingeben soll. Dieses Element wird ignoriert, wenn AbortTransition = TRUE ist. Wenn der Prozessor N-Leerlaufzustände unterstützt, reichen die Indizes im Leerlauf von 0 bis N–1. Der PEP hat die Anzahl der unterstützten Leerlaufzustände für diesen Prozessor als Reaktion auf eine vorherige PEP_NOTIFY_PPM_QUERY_IDLE_STATES Benachrichtigung angegeben.

[out] DependencyArrayUsed

Die Anzahl der Arrayelemente, die der PEP tatsächlich in den Ausgabepuffer geschrieben hat, zeigt auf den DependencyArray-Member .

[in] DependencyArrayCount

Die maximale Anzahl von Elementen im Array, auf die das DependencyArray-Element verweist. Der DependencyArrayCount-Memberwert entspricht dem MaximumCoordinatedProcessors-Wert , den pep zuvor als Reaktion auf die PEP_NOTIFY_PPM_QUERY_IDLE_STATES-Benachrichtigung angegeben hat.

[in] DependencyArray

Ein Zeiger auf einen Ausgabepuffer, in den pep ein Array von PEP_PROCESSOR_IDLE_DEPENDENCY Strukturen schreibt. Die Elemente dieses Arrays geben Prozessor-Leerlaufabhängigkeiten oder Reaktivierungsabhängigkeiten an, die erfüllt sein müssen, damit dieser Übergang im Leerlauf erfolgreich ist. Pep legt den DependencyArrayUsed-Member auf die tatsächliche Anzahl von Arrayelementen fest, die pep in den Puffer schreibt. Der Ausgabepuffer wird vom Windows Power Management Framework (PoFx) zugeordnet und ist garantiert groß genug, um die Anzahl der Arrayelemente zu enthalten, die vom DependencyArrayCount-Member angegeben werden.

[out] PlatformIdleStateIndex

Der Index des Plattform-Leerlaufzustands, den die Plattform eingeben soll, wenn der Prozessor in den ausgewählten Prozessor-Leerlaufzustand wechselt. Der PEP sollte diesen Member nur festlegen, wenn die Plattform gleichzeitig mit dem Prozessor in einen Leerlaufzustand wechselt. Dieses Element wird ignoriert, wenn AbortTransition true ist.

Hinweise

Diese Struktur wird von der PEP_NOTIFY_PPM_IDLE_SELECT Benachrichtigung verwendet. Die Member Constraints, DependencyArrayCount und DependencyArray der Struktur enthalten Eingabewerte, die von PoFx bereitgestellt werden, wenn diese Benachrichtigung gesendet wird. Die restlichen Member enthalten Ausgabewerte, die pep als Reaktion auf die Benachrichtigung in die Struktur schreibt.