RequestPowerNotifications (Windows Embedded CE 6.0)

1/6/2010

This function enables applications and drivers to register for power notification events.

Syntax

HANDLE RequestPowerNotifications(
  HANDLE hMsgQ,
  DWORD Flags
);

Parameters

• hMsgQ
  [in] Handle to the application 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 notifications.

  Notification	Description
  PBT_POWERINFOCHANGE	Broadcast specifying that a battery power status field has changed. This notification has an associated POWER_BROADCAST_POWER_INFO structure.
  PBT_POWERSTATUSCHANGE	Broadcast specifying that the power supply has switched either from AC to DC or from DC to AC.
  PBT_RESUME	Broadcast notifying that the system is resuming and specifies the previous state.
  PBT_TRANSITION	Broadcast specifying the system power state transition.

Return Value

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.

See Also

Reference

POWER_BROADCAST
StopPowerNotifications

Other Resources

Power Management Functions
CreateMsgQueue