POFXCALLBACKUPDATEPLATFORMIDLESTATE-Rückruffunktion (pepfx.h)

Artikel
02/29/2024

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. Das PEP hat dieses Handle zuvor von PoFx während der PEP_DPM_REGISTER_DEVICE Benachrichtigung erhalten, in der pep darüber informiert wurde, dass der Prozessor bei PoFx registriert wurde.

[in] PlatformState

Ein Index, der den Leerlaufstatus 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 Leerlaufstatus der N-Plattform angegeben hat, reichen gültige 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 sind die folgenden status Codes.

Rückgabewert	BESCHREIBUNG
STATUS_NOT_SUPPORTED	Die Versionsnummer in der PEP_PLATFORM_IDLE_STATE_UPDATE-Struktur ist kein unterstützter Wert.
STATUS_NOT_IMPLEMENTED	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)	Unterstützt ab Windows 10.
Zielplattform	Windows
Kopfzeile	pepfx.h (include Pep_x.h)
IRQL	PASSIVE_LEVEL