PEPCALLBACKNOTIFYDPM-Rückruffunktion (pep_x.h)

  • Artikel

Eine AcceptDeviceNotification-Ereignisrückrufroutine verarbeitet DPM-Benachrichtigungen (Device Power Management) aus dem Windows Power Management Framework (PoFx).

Syntax

PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;

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

Parameter

[in] Notification

Die DPM-Benachrichtigungs-ID. Dieser Parameter gibt den Typ der DPM-Benachrichtigung an, die PoFx sendet. Eine Liste der DPM-Benachrichtigungs-IDs finden Sie unter Benachrichtigungen zur Geräteenergieverwaltung (DEVICE Power Management, DPM).

[in, out, optional] Data

Ein Zeiger auf eine durch 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 DPM-Benachrichtigungs-IDs definiert sind, finden Sie unter DpM-Benachrichtigungen (Device Power Management).

Rückgabewert

Die AcceptDeviceNotification-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 ein Gerät implementiert. Der AcceptDeviceNotification-Member der PEP_INFORMATION-Struktur ist ein Zeiger auf eine AcceptDeviceNotification-Routine . Der PEP ruft die Routine PoFxRegisterPlugin oder PoFxRegisterPluginEx auf, um die AcceptDeviceNotification-Routine des PEP bei PoFx zu registrieren.

PoFx ruft diese Routine auf, um eine DPM-Benachrichtigung an pep zu senden. In diesem Aufruf gibt der Notification-Parameter den Typ der Benachrichtigung an, und der Data-Parameter verweist auf eine Datenstruktur des Typs, der dieser Benachrichtigung zugeordnet ist. Eine Liste der DPM-Benachrichtigungs-IDs und der zugehörigen Strukturtypen finden Sie unter Benachrichtigungen zur Geräteenergieverwaltung (DEVICE Power Management, DPM).

DPM-Benachrichtigungen informieren pep über verschiedene System-, Geräte- oder Komponentenereignisse oder übergeben Anforderungen vom Gerätetreiber an pep.

Die AcceptDeviceNotification-Routine muss nicht jede Anforderung des Gerätetreibers akzeptieren, z. B. kann sie Hinweise zum Aufenthalt im Leerlauf ignorieren. Der PEP muss jedoch die meisten Benachrichtigungen zur Geräteenergieverwaltung verstehen und akzeptieren, auch wenn der PEP nicht darauf reagiert. Der PEP muss jede nicht erkannte Benachrichtigung ablehnen (indem er FALSE zurückgibt).

Die AcceptDeviceNotification-Routine kann unter IRQL <= DISPATCH_LEVEL aufgerufen werden. Die IRQL, an der die AcceptAcpiNotification-Routine des PEP aufgerufen wird, variiert je nach Art der gesendeten Benachrichtigung. Der Benachrichtigungstyp wird durch den Notification-Parameter angegeben. Weitere Informationen finden Sie auf den einzelnen Referenzseiten unter Benachrichtigungen zur Geräteenergieverwaltung (DEVICE Power Management, DPM).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt ab Windows 10.
Zielplattform Windows
Kopfzeile pep_x.h (Pep_x.h einschließen)
IRQL <= DISPATCH_LEVEL

Weitere Informationen

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx