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.
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
10/16/2008
This class represents a tuning data message.
Syntax
class TuningDataMsg : public Msg
Methods
| Method | Description |
|---|---|
Returns the requested adjacent frequencies. |
|
Returns the call sign of the station broadcasting the MSN Direct data. |
|
Returns the current tuning frequency of the FM radio. |
|
Returns the number of adjacent frequencies in the payload of this tuning data message. |
|
Returns the size of the payload of this tuning data message. |
|
Returns the ID of the current region. |
|
Returns the strength of the FM radio signal. |
|
Returns the tuning status of the FM radio. |
Remarks
A tuning data message from the MSN Direct receiver includes information about the tuning parameters of the FM radio that communicates with the Microsoft DirectBand wireless datacasting network. This message is typically sent by the host device when it requests the tuning state.
This message inherits from Msg Class.
When the MSN Direct receiver is in steady state mode, it will expect a tuning data-message query from the host device every 15 seconds, unless other transactions are present on the serial connection. The tuning data message sent by the host contains an empty payload, either as a tuning query when the host initiates the transaction, or as a response message. The tuning data message is used by the receiver to determine the status and strength of the connection and can be used by the host device to inform the user about the radio reception. For more information, see DBR701::IsConnectionAlive.
If the MSN Direct service type is TUNING_DATA, then the incoming message is a tuning data message. You can typecast it to a TuningDataMsg object.
In MSN Direct services for Windows Embedded CE, the host device is the Windows Embedded CE powered device.
Requirements
| Header | DBRLib.h |
| Library | DBRLib.lib |
| Windows Embedded CE | Windows CE 5.0, Windows Embedded NavReady 2009 |