PEP_PPM_IDLE_SELECT Struktur (pep_x.h)
Die PEP_PPM_IDLE_SELECT-Struktur beschreibt den energieeffizientesten Leerlaufzustand, den der Prozessor eingeben und dennoch 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;
Angehörige
[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 zum Leerlaufzustand eines Prozessors abgebrochen werden soll. Legen Sie dieses Element auf TRUE fest, wenn das Betriebssystem das Betriebssystem benötigt, um den ausstehenden Übergang abzubrechen, und andernfalls auf FALSE. Der PEP wählt diese Option aus, wenn er Arbeiten in die Warteschlange stellen möchte und den Windows-Kernelprozess ausführen soll, bevor der Prozessor in den Leerlauf wechselt.
[out] IdleStateIndex
Der Index, der den Leerlaufstatus angibt, den der Prozessor eingeben soll. Dieses Element wird ignoriert, wenn AbortTransition = TRUE. Wenn der Prozessor N-Leerlaufzustände unterstützt, reichen die Indizes des Leerlaufzustands von 0 bis N bis 1. Der PEP lieferte die Anzahl der unterstützten Leerlaufzustände für diesen Prozessor als Reaktion auf eine vorherige PEP_NOTIFY_PPM_QUERY_IDLE_STATES-Benachrichtigung.
[out] DependencyArrayUsed
Die Anzahl der Arrayelemente, die der PEP tatsächlich in den Ausgabepuffer geschrieben hat, verweist auf das DependencyArray Member.
[in] DependencyArrayCount
Die maximale Anzahl von Elementen im Array, auf die durch das DependencyArray Member verwiesen wird. Der DependencyArrayCount Memberwert entspricht dem wert MaximumCoordinatedProcessors Wert, den der PEP zuvor als Reaktion auf die PEP_NOTIFY_PPM_QUERY_IDLE_STATES-Benachrichtigung bereitgestellt hat.
[in] DependencyArray
Ein Zeiger auf einen Ausgabepuffer, in den der PEP ein Array von PEP_PROCESSOR_IDLE_DEPENDENCY Strukturen schreibt. Die Elemente dieses Arrays geben Prozessor-Leerlaufabhängigkeiten oder Wake-Abhängigkeiten an, die erfüllt werden müssen, damit dieser Leerlauf erfolgreich verläuft. Der PEP legt die DependencyArrayUsed Member auf die tatsächliche Anzahl von Arrayelementen fest, die der PEP in den Puffer schreibt. Der Ausgabepuffer wird vom Windows Power Management Framework (PoFx) zugewiesen und ist garantiert groß genug, um die Anzahl der Arrayelemente zu enthalten, die vom DependencyArrayCount Member angegeben werden.
[out] PlatformIdleStateIndex
Der Index des Leerlaufzustands der Plattform, in den die Plattform eingegeben werden soll, wenn der Prozessor den ausgewählten Prozessor-Leerlaufstatus eingibt. Der PEP sollte dieses Mitglied nur festlegen, wenn die Plattform gleichzeitig mit dem Prozessor in einen Leerlaufzustand wechselt. Dieses Element wird ignoriert, wenn AbortTransition WAHR ist.
Bemerkungen
Diese Struktur wird von der PEP_NOTIFY_PPM_IDLE_SELECT-Benachrichtigung verwendet. Die Constraints, DependencyArrayCountund DependencyArray Member der Struktur enthalten Eingabewerte, die von PoFx beim Senden dieser Benachrichtigung bereitgestellt werden. Die verbleibenden Member enthalten Ausgabewerte, die der PEP als Reaktion auf die Benachrichtigung in die Struktur schreibt.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Wird ab Windows 10 unterstützt. |
Header- | pep_x.h (einschließlich Pepfx.h) |
Siehe auch
PEP_NOTIFY_PPM_QUERY_IDLE_STATES