POFXCALLBACKUPDATEPLATFORMIDLESTATE callback function (pepfx.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) mit dem Windows Power Management Framework (PoFx) darstellt. Der PEP erhielt dieses Handle zuvor von PoFx während der PEP_DPM_REGISTER_DEVICE Benachrichtigung, dass der PEP informiert wurde, dass der Auftragsverarbeiter bei PoFx registriert wurde.

[in] PlatformState

Ein Index, der den Leerlaufstatus der Plattform identifiziert, deren Eigenschaften aktualisiert werden sollen. Als Reaktion auf eine vorherige PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES-Benachrichtigung hat der PEP die Anzahl der unterstützten Plattform-Leerlaufzustände angegeben. Wenn der pep angegebene N Plattform im Leerlauf zugibt, reichen gültige Indexe des Plattform-Leerlaufzustands von 0 bis N-1. Als Reaktion auf eine vorherige PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE-Benachrichtigung hat der PEP die Eigenschaften dieses Plattform-Leerlaufzustands angegeben.

[in] Update

Ein Zeiger auf eine PEP_PLATFORM_IDLE_STATE_UPDATE-Struktur, die die aktualisierten Eigenschaften des Leerlaufzustands der Plattform 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 Statuscodes.

Bemerkungen

Diese Routine wird von PoFx implementiert und wird vom PEP aufgerufen. Der UpdatePlatformIdleState Member der PEP_KERNEL_INFORMATION_STRUCT_V3-Struktur ist ein Zeiger auf eine UpdatePlatformIdleState Routine.

Der PEP muss warten, bis alle PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE Benachrichtigungen abgeschlossen wurden, um die UpdatePlatformIdleState Routine aufzurufen.

Die UpdatePlatformIdleState Routine muss bei IRQL = PASSIVE_LEVEL aufgerufen werden.

Anforderungen

Siehe auch

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE