DBR701 Class

10/16/2008

This class enables communication with the MSN Direct receiver by implementing the low-level details of the MSN Direct protocol on the host device.

Syntax

class DBR701

Methods

Method	Description
DBR701 Constructor	Initializes an instance of the DBR701 class.
DBR701 Destructor	Closes all open handles and threads.
DBR701::FirmwareUpgradeCompletionPercentage	Returns the degree of completion of the current MSN Direct receiver firmware upgrade, if an upgrade is currently being performed.
DBR701::GetCapEmergencyAlertsCore	Requests the Common Alerting Protocol (CAP) core emergency alerts from the MSN Direct receiver.
DBR701::GetCapEmergencyAlertsSuppl	Requests up-to-date data about CAP emergency supplemental alerts from the MSN Direct receiver.
DBR701::GetDownloadStatus	Requests the status of the download from the MSN Direct receiver.
DBR701::GetGasPrices	Requests up-to-date data about gas prices at local gas stations from the MSN Direct receiver.
DBR701::GetGasStations	Requests up-to-date data about local gas stations from the MSN Direct receiver.
DBR701::GetGroupMessages	Requests up-to-date data for group messages from the MSN Direct receiver.
DBR701::GetLocalEvents	Requests up-to-date data about events that are occurring in the local area from the MSN Direct receiver. Local-events data includes the event name, the address of the event, and a contact phone number.
DBR701::GetLocalTime	Requests up-to-date data for the local time from the MSN Direct receiver.
DBR701::GetMovieProperties	Requests up-to-date data about movie properties from the MSN Direct receiver. Movie properties include genre, rating, and actors.
DBR701::GetMovieTheaters	Requests up-to-date data about movie theaters in the local area from the MSN Direct receiver.
DBR701::GetMovieTimes	Requests up-to-date data about movie show times from the MSN Direct receiver.
DBR701::GetMovieTitles	Requests up-to-date data about movie titles from the MSN Direct receiver.
DBR701::GetNewsItems	Requests up-to-date data about news items for major news stories from the MSN Direct receiver.
DBR701::GetNewTransaction	Increments the transaction counter and returns the new transaction count.
DBR701::GetNonLocalWeather	Requests up-to-date data about weather conditions in major cities across the country/region.
DBR701::GetPowerStatus	Requests up-to-date data about the power status from the MSN Direct receiver. Power-status information includes battery power level.
DBR701::GetRegistration	Requests registration data from the MSN Direct receiver.
DBR701::GetStockQuotes	Requests up-to-date data about stock quotes from the MSN Direct receiver. Stock-quotes data includes prices, daily highs, daily lows, and trading volume.
DBR701::GetStockSymbols	Requests up-to-date data about stock symbols from the MSN Direct receiver.
DBR701::GetSubscriberStatus	Requests the status on whether the MSN Direct receiver is currently subscribed to MSN Direct services over the Microsoft DirectBand Network.
DBR701::GetTrafficFlowEvents	Requests up-to-date data about traffic-flow events from the MSN Direct receiver. Traffic-flow events data includes event duration, event extent, and traffic-flow speed in miles per hour.
DBR701::GetTrafficIncidents	Requests up-to-date data about traffic incidents from the MSN Direct receiver. Traffic-incidents data includes warnings about events that block traffic flow, such as accidents, road closures, and road construction in the local area.
DBR701::GetTuningData	Requests tuning data from the MSN Direct receiver. Tuning data includes strength, frequency, and signal status.
DBR701::GetUserLocations	Requests up-to-date data about favorite locations that you sent to the MSN Direct receiver from a desktop PC by using the Send to GPS feature of Live Search.
DBR701::GetVersion	Requests protocol-version information from the MSN Direct receiver.
DBR701::GetWeather	Requests up-to-date data about weather conditions in the local area from the MSN Direct receiver. Weather conditions include temperature, wind direction, and pressure trend.
DBR701::GetWeatherAlerts	Requests up-to-date data for weather alerts from the MSN Direct receiver. A weather alert describes a weather event in the local area.
DBR701::IsConnectionAlive	Indicates whether the connection with the MSN Direct receiver is currently active.
DBR701::IsProtocolInFlashMode	Indicates whether the MSN Direct protocol is in flash mode.
DBR701::Open	Resets the state machine, opens the serial port that has the specified name, and starts the internal HeartBeatThread, if it is not already running.
DBR701::PrepareSimpleResponseMessage	Prepares a simple response message that will be sent to the MSN Direct receiver. This message provides feedback about an incoming message that was accepted from the receiver.
DBR701::ProcessInMessageFromReceiver	Processes a message that was accepted from the MSN Direct receiver. This method is called internally to process a full frame every time a full frame is read from the MSN Direct receiver without errors.
DBR701::ReadPowerStatusFromApplication	Responds to a call that occurs when the host device must answer a power-status request sent from the MSN Direct receiver.
DBR701::RequestManufacturingMode	Requests that the MSN Direct receiver is transitioned into manufacturing mode.
DBR701::RequestSwitchRadio	Requests that the FM radio on the MSN Direct receiver be switched ON or switched OFF.
DBR701::RequestSync	Requests up-to-date data for the specified MSN Direct service.
DBR701::ResetTransactionCounter	Sets the transaction counter to 0.
DBR701::SendRequestSync	Sends the specified message to the MSN Direct receiver synchronously. It blocks until a response is received, or until the time-out period expires.
DBR701::UpgradeFirmware	Initiates a firmware upgrade on the MSN Direct receiver that starts in a separate thread.

Remarks

You must subclass the DBR701 class and override the ProcessInMessageFromReceiver method in order to provide custom message-handling routines for all message types supported by the MSN Direct application. To start communications with the MSN Direct receiver, the application can call the Open method.

In the pull model for exchanging messages, the ProcessInMessageFromReceiver method is invoked to respond to a previous request by calling one of the Get* methods. In the push model, the ProcessInMessageFromReceiver method is invoked when the receiver sends refreshed, up-to-date data to the host device.

The MSN Direct application must handle messages received through ProcessInMessageFromReceiver and return the appropriate application type in the responseMessage output parameter. Note that this method is executed on one of the threads from the pool of application-callback threads. Therefore, the MSN Direct application might have to use the appropriate thread-synchronization mechanisms when it handles messages sent from the MSN Direct receiver.

The MSN Direct library does not maintain any type of cache for messages. Therefore, the MSN Direct application must create and maintain thread-safe caches for all messages, and also replace or delete expired messages. The MSN Direct library does not process the contents of messages; it only performs minimal message parsing and simply parses messages from the MSN Direct receiver before routing them to the MSN Direct application.

In MSN Direct services for Windows Embedded CE, the host device is the Windows Embedded CE–based device.

Requirements

Header	DBR701.h
Library	DBRLib.lib
Windows Embedded CE	Windows CE 5.0, Windows Embedded NavReady 2009

See Also

Reference

MSN Direct Services Classes