共用方式為


POWER_BROADCAST

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure is used to issue power notification events through message queues.

Syntax

struct {
  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_POWERSTATUSCHANGE

    Power supply switched to/from AC/DC.

    PBT_RESUME

    Resume from previous state.

    PBT_TRANSITION

    System power state transition.

  • Flags
    Use one of the system power flags shown in the following table.

    System power flag Description

    POWER_STATE_BOOT

    Boot state.

    POWER_STATE_CRITICAL

    Critical off.

    POWER_STATE_IDLE

    Idle state.

    POWER_STATE_ON

    On state.

    POWER_STATE_OFF

    No power, full off.

    POWER_STATE_RESET

    Reset state.

    POWER_STATE_SUSPEND

    Suspended 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 unregister 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.

See Also

Reference

Power Management Structures
RequestPowerNotifications
StopPowerNotifications