PEPCALLBACKNOTIFYDPM-Rückruffunktion (pepfx.h)
Eine AcceptDeviceNotification Ereignisrückrufroutine verarbeitet DpM-Benachrichtigungen (Device Power Management) aus dem Windows Power Management Framework (PoFx).
PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;
BOOLEAN Pepcallbacknotifydpm(
[in] ULONG Notification,
[in, out, optional] PVOID Data
)
{...}
[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 DPM-Benachrichtigungen (Device Power Management).
[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 Notificationangegebenen 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).
The AcceptDeviceNotification routine must return TRUE if it handles the notification, or FALSE if it does not.
Diese Routine wird vom Plattformerweiterungs-Plug-In (PEP) für ein Gerät implementiert. Das AcceptDeviceNotification Member der PEP_INFORMATION-Struktur ist ein Zeiger auf eine AcceptDeviceNotification Routine. Der PEP ruft die PoFxRegisterPlugin oder PoFxRegisterPluginEx Routine auf, um die AcceptDeviceNotification Routine von PEP bei PoFx zu registrieren.
PoFx ruft diese Routine auf, um eine DPM-Benachrichtigung an den PEP zu senden. In diesem Aufruf gibt der Parameter Notification den Typ der Benachrichtigung an, und der parameter Data 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 DPM-Benachrichtigungen (Device Power Management).
DPM-Benachrichtigungen informieren den PEP über verschiedene System-, Geräte- oder Komponentenereignisse oder übergeben Anforderungen vom Gerätetreiber an den PEP.
Die AcceptDeviceNotification- Routine muss nicht jede Anforderung vom Gerätetreiber annehmen, z. B. kann die Idle-Residency-Hinweise ignoriert werden. Der PEP muss jedoch die meisten Geräte-Energieverwaltungsbenachrichtigungen verstehen und akzeptieren, auch wenn der PEP entscheidet, nicht darauf zu reagieren. Der PEP muss sich weigern, jede Benachrichtigung, die sie nicht erkennt, zu behandeln (durch Zurückgeben von FALSCH).
Die AcceptDeviceNotification Routine kann bei IRQL-<= DISPATCH_LEVEL aufgerufen werden. Die IRQL, bei der die AcceptAcpiNotification Routine des PEP aufgerufen wird, hängt vom Typ der gesendeten Benachrichtigung ab. Der Benachrichtigungstyp wird durch den Parameter Notification angegeben. Weitere Informationen finden Sie auf den einzelnen Referenzseiten unter DPM-Benachrichtigungen (Device Power Management).
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 10 unterstützt. |
| Zielplattform- | Fenster |
| Header- | pepfx.h (include Pep_x.h) |
| IRQL- | <= DISPATCH_LEVEL |