POWER_BROADCAST (Windows CE 5.0)
This structure is used to issue power notification events through message queues.
typedef struct _POWER_BROADCAST {DWORD Message;DWORD Flags;DWORD Length;WCHAR SystemPowerState[1];} POWER_BROADCAST, *PPOWER_BROADCAST;
Members
- Message
This field defines the event type. Set to one of the events shown in the following table.Event type Description PBT_TRANSITION System power state transition. PBT_RESUME Resume from previous state. PBT_POWERSTATUSCHANGE Power supply switched to/from AC/DC. PBT_POWERINFOCHANGE A member of the POWER_BROADCAST_POWER_INFO structure has changed. - Flags
Use one of the system power flags shown in the following table.System power flag Description POWER_STATE_ON On state. POWER_STATE_OFF No power, full off. POWER_STATE_CRITICAL Critical off. POWER_STATE_BOOT Boot state. POWER_STATE_IDLE Idle state. POWER_STATE_SUSPEND Suspend state. POWER_STATE_RESET Reset state. - Length
The byte count of SystemPowerState. - SystemPowerState
The named system power state Flags.
Remarks
Applications and drivers register for power events with RequestPowerNotifications and deregister with StopPowerNotifications. Power notification events are issued in a POWER_BROADCAST structure, through message queues.
These notifications are multicast messages that are sent only to applications and drivers that have registered to receive the messages.
The POWER_BROADCAST structure has a variable length. The SystemPowerState array is a placeholder for data associated with the message being broadcast and is not always WCHAR data. For example, the PBT_POWERINFOCHANGE message embeds a POWER_BROADCAST_POWER_INFO structure.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Pm.h.
See Also
RequestPowerNotifications | StopPowerNotifications
Send Feedback on this topic to the authors