PEPCALLBACKNOTIFYPPM-Rückruffunktion (pep_x.h)

  • Artikel

Eine AcceptProcessorNotification-Ereignisrückrufroutine verarbeitet PPM-Benachrichtigungen (Processor Power Management) aus dem Windows Power Management Framework (PoFx).

Syntax

PEPCALLBACKNOTIFYPPM Pepcallbacknotifyppm;

BOOLEAN Pepcallbacknotifyppm(
  [in]                PEPHANDLE Handle,
  [in]                ULONG Notification,
  [in, out, optional] PVOID Data
)
{...}

Parameter

[in] Handle

Das Gerätehandle für den PEP für den Zielprozessor. Bei NULL richtet sich die Benachrichtigung nicht an einen bestimmten Prozessor.

[in] Notification

Die PPM-Benachrichtigungs-ID. Dieser Parameter gibt den Typ der PPM-Benachrichtigung an, die PoFx sendet. Eine Liste der PPM-Benachrichtigungs-IDs finden Sie unter Benachrichtigungen zur Prozessorenergieverwaltung (PPM).

[in, out, optional] Data

Ein Zeiger auf eine poFx-zugeordnete Struktur, die die Eingabe- und/oder Ausgabedaten für diese Benachrichtigung enthält. Der Typ dieser Struktur hängt von der durch Benachrichtigung angegebenen Benachrichtigungs-ID ab. Eine Liste der Strukturtypen, die für die verschiedenen PPM-Benachrichtigungs-IDs definiert sind, finden Sie unter Benachrichtigungen zur Prozessorenergieverwaltung (PPM).

Rückgabewert

Die AcceptProcessorNotification-Routine muss TRUE zurückgeben, wenn sie die Benachrichtigung verarbeitet, oder FALSE, wenn dies nicht der Fall ist.

Hinweise

Diese Routine wird durch das Plattformerweiterungs-Plug-In (PEP) für einen Prozessor implementiert. Das AcceptProcessorNotification-Element der PEP_INFORMATION-Struktur ist ein Zeiger auf eine AcceptProcessorNotification-Routine . Pep ruft die PoFxRegisterPlugin - oder PoFxRegisterPluginEx-Routine auf, um die AcceptProcessorNotification-Routine von PEP bei PoFx zu registrieren.

Die IRQL, bei der die AcceptProcessorNotification-Routine des PEP aufgerufen wird, hängt vom Typ der gesendeten Benachrichtigung ab. Der Kontext, in dem diese Schnittstelle aufgerufen wird, reicht von PASSIVE_LEVEL bis zu HIGH_LEVEL mit deaktivierten Interrupts. Weitere Informationen zur IRQL, an der die einzelnen Benachrichtigungstypen gesendet werden, finden Sie auf den einzelnen Referenzseiten unter Benachrichtigungen zur Prozessorleistungsverwaltung (PPM).

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 zu HIGH_LEVEL

Weitere Informationen

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx