Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function allows applications and drivers to register for power notification events.
HANDLE RequestPowerNotifications(HANDLE hMsgQ,DWORD Flags);
Parameters
hMsgQ
[in] Handle to the application's message queue created with CreateMsgQueue.Flags
[in] Set to the logical-or of the desired PBT_XXX notifications, or to POWER_NOTIFY_ALL to receive all notifications.The following table shows the various PBT_XXX notifications.
Notification Description PBT_TRANSITION Broadcast specifying the system power state transition. PBT_RESUME Broadcast notifying a resume and specifies the previous state. PBT_POWERSTATUSCHANGE Broadcast specifying that the power supply has switched either from AC to DC or from DC to AC. PBT_POWERINFOCHANGE Broadcast specifying that a battery power status field has changed. This notification has an associated POWER_BROADCAST_POWER_INFO structure.
Return Values
Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.
Remarks
Power notification events are issued in a POWER_BROADCAST structure through message queues.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Pm.h.
Link Library: Coredll.lib.
See Also
CreateMsgQueue | POWER_BROADCAST | StopPowerNotifications
Send Feedback on this topic to the authors