Share via

BROADCAST_PROVIDER_SPECIFIC_DATA

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Use the Global System for Mobile Communications (GSM) broadcast provider to support incoming cell broadcast messages. This is a receive-only provider.

Syntax

typedef struct broadcast_provider_specific_data_tag {
    WORD wMessageID;
    WORD wMessageCode;
    BROADCAST_PROVIDER_SPECIFIC_GEOGRAPHICAL_SCOPE bpsgsGeographicalScope;
    WORD wUpdateNumber;
} BROADCAST_PROVIDER_SPECIFIC_DATA;

Members

  • wMessageID
    The message ID identifies a particular type of message, such as traffic reports.
  • wMessageCode
    The message code is used to distinguish broadcast messages of the same message ID. For instance, there may be multiple traffic incidents with constant updates. Each incident would have its own broadcast message code.
  • bpsgsGeographicalScope
    The geographic scope over which the message is unique. See the BROADCAST_PROVIDER_SPECIFIC_GEOGRAPHICAL_SCOPE enumeration for possible values.
  • wUpdateNumber
    A 4-bit number indicating a change in message content for the same message. A value 8 or less higher than the previously received message should be considered newer as described in GSM specification 03.41 "Digital cellular telecommunications system (Phase 2+); Technical realization of Cell Broadcast Service (CBS)."

Remarks

Broadcast messages may come as multiple fragments (up to 16), or "pages" as described in GSM specification 03.41 "Digital cellular telecommunications system (Phase 2+); Technical realization of the Cell Broadcast Service (CBS)." The provider will not deliver a message until all of its fragments have been received.

Broadcast index messages indicate the list of broadcast message types that the mobile can register for. The structure of such a message is defined in GSM specification 03.41. Current behavior with regard to broadcast index messages is that such messages will be routed in the same fashion as other broadcast messages.

Requirements

Header sms.h
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Smartphone 2002 and later

See Also

Reference

Short Message Service Structures
BROADCAST_PROVIDER_SPECIFIC_GEOGRAPHICAL_SCOPE