POFXCALLBACKUPDATEPLATFORMIDLESTATE-Rückruffunktion (pep_x.h)
Die UpdatePlatformIdleState-Routine wird vom Plattformerweiterungs-Plug-In (PEP) aufgerufen, um die Eigenschaften des angegebenen Plattform-Leerlaufzustands zu aktualisieren.
Syntax
POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;
NTSTATUS Pofxcallbackupdateplatformidlestate(
[in] POHANDLE ProcessorHandle,
[in] ULONG PlatformState,
[in] PPEP_PLATFORM_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] PlatformState
Ein Index, der den Leerlaufzustand der Plattform identifiziert, dessen Eigenschaften aktualisiert werden sollen. Als Reaktion auf eine vorherige PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES Benachrichtigung hat pep die Anzahl der unterstützten Plattform-Leerlaufzustände angegeben. Wenn der PEP den N-Plattform-Leerlaufzustand angegeben hat, reichen die gültigen Plattform-Leerlaufstatusindizes von 0 bis N-1. Als Reaktion auf eine vorherige PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE Benachrichtigung hat pep die Eigenschaften dieses Plattform-Leerlaufzustands angegeben.
[in] Update
Ein Zeiger auf eine PEP_PLATFORM_IDLE_STATE_UPDATE-Struktur , die die aktualisierten Eigenschaften des Plattform-Leerlaufzustands enthält.
Rückgabewert
UpdatePlatformIdleState gibt STATUS_SUCCESS zurück, wenn die Eigenschaften des Plattform-Leerlaufzustands erfolgreich aktualisiert werden. Mögliche Fehlerrückgabewerte umfassen die folgenden status-Codes.
Rückgabewert | BESCHREIBUNG |
---|---|
|
Die Versionsnummer in der PEP_PLATFORM_IDLE_STATE_UPDATE-Struktur ist kein unterstützter Wert. |
|
Die UpdatePlatformIdleState-Routine ist für diesen Prozessor nicht implementiert. |
Hinweise
Diese Routine wird von PoFx implementiert und vom PEP aufgerufen. Das UpdatePlatformIdleState-Element der PEP_KERNEL_INFORMATION_STRUCT_V3-Struktur ist ein Zeiger auf eine UpdatePlatformIdleState-Routine .
Pep muss warten, bis alle PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE Benachrichtigungen abgeschlossen sind, um die UpdatePlatformIdleState-Routine aufzurufen.
Die UpdatePlatformIdleState-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 |
Weitere Informationen
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für