POFXCALLBACKUPDATEPROCESSORIDLESTATE-Rückruffunktion (pep_x.h)
Die UpdateProcessorIdleState-Routine wird vom Plattformerweiterungs-Plug-In (PEP) aufgerufen, um die Eigenschaften des angegebenen Prozessor-Leerlaufzustands zu aktualisieren.
Syntax
POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;
NTSTATUS Pofxcallbackupdateprocessoridlestate(
[in] POHANDLE ProcessorHandle,
[in] ULONG ProcessorState,
[in] PPEP_PROCESSOR_IDLE_STATE_UPDATE Update
)
{...}
Parameter
[in] ProcessorHandle
Ein POHANDLE-Wert, der die Registrierung des Prozessors (als Gerät) beim Windows Power Management Framework (PoFx) darstellt. Der PEP hat diesen Handle zuvor von PoFx während der PEP_DPM_REGISTER_DEVICE Benachrichtigung erhalten, die pep darüber informierte, dass der Prozessor bei PoFx registriert wurde.
[in] ProcessorState
Ein Index, der den Leerlaufzustand des Prozessors identifiziert, dessen Eigenschaften aktualisiert werden sollen. Als Reaktion auf eine vorherige PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 Benachrichtigung hat pep die Anzahl der unterstützten Prozessor-Leerlaufzustände und die Eigenschaften dieser Zustände angegeben. Wenn im PEP angegebenen N-Prozessor-Leerlaufzustände angegeben werden, reichen die gültigen Prozessor-Leerlaufzustandsindizes von 0 bis N-1.
[in] Update
Ein Zeiger auf eine PEP_PROCESSOR_IDLE_STATE_UPDATE Struktur, die die aktualisierten Eigenschaften des Prozessor-Leerlaufzustands enthält.
Rückgabewert
UpdateProcessorIdleState gibt STATUS_SUCCESS zurück, wenn die Eigenschaften des Prozessors im Leerlaufzustand erfolgreich aktualisiert werden. Mögliche Fehlerrückgabewerte umfassen die folgenden status-Codes.
| Rückgabewert | BESCHREIBUNG |
|---|---|
|
Die Versionsnummer in der PEP_PROCESSOR_IDLE_STATE_UPDATE-Struktur ist kein unterstützter Wert. |
|
Die UpdateProcessorIdleState-Routine ist für diesen Prozessor nicht implementiert. |
Hinweise
Diese Routine wird von PoFx implementiert und vom PEP aufgerufen. Das UpdateProcessorIdleState-Element der PEP_KERNEL_INFORMATION_STRUCT_V3-Struktur ist ein Zeiger auf eine UpdateProcessorIdleState-Routine .
Die UpdateProcessorIdleState-Routine muss unter IRQL = PASSIVE_LEVEL aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Wird ab Windows 10 unterstützt. |
| Zielplattform | Windows |
| Kopfzeile | pep_x.h (einschließlich Pep_x.h) |
| IRQL | PASSIVE_LEVEL |