DBR701::GetTuningData
.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 method requests tuning data from the MSN Direct receiver. Tuning data includes strength, frequency, and signal status.
Syntax
int GetTuningData();
Parameters
None.
Return Value
Returns the transaction ID of the request that is sent to the MSN Direct receiver; returns -1 if the request fails.
Remarks
The GetTuningData method uses RequestSync to perform the transaction, with TUNING_DATA specified as the applicationType parameter.
If the MSN Direct service type is TUNING_DATA, then the incoming message from the MSN Direct receiver is a tuning-status message returned as a TuningDataMsg object instance on a ProcessInMessageFromReceiver call. The MsgFromReceiver::GetApplicationType method must be called to verify for errors. In case of an error, the GetApplicationType method will return PROTOCOL_ERROR. Otherwise, the GetApplicationType method will return TUNING_DATA. In this case, the messageFromReceiver parameter must be typecast to a TuningDataMsg object and processed accordingly.
Requirements
| Header | DBR701.h |
| Library | DBRLib.lib |
| Windows Embedded CE | Windows CE 5.0, Windows Embedded NavReady 2009 |
See Also
Reference
DBR701::GetSubscriberStatus
DBR701 Class
MSN Direct Services Classes