DBR701::RequestSwitchRadio
.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 that the FM radio on the MSN Direct receiver be switched ON or switched OFF.
Syntax
int RequestSwitchRadio(
bool on
);
Parameters
on
[in] Indicates whether this function requests that the radio be switched ON or switched OFF.A value of true indicates to switch the FM radio ON; a value of false indicates to switch the FM radio OFF.
Return Value
Returns the transaction ID of the request that is sent to the receiver; returns -1 if the request fails.
Remarks
If the MSN Direct service type is FM_RADIO_STATUS, then the incoming message from the MSN Direct receiver is a radio current-status message returned as a RadioStatusMsg 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 FM_RADIO_STATUS. In this case, the messageFromReceiver parameter of ProcessInMessageFromReceiver must be typecast to a RadioStatusMsg instance 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::RequestManufacturingMode
DBR701 Class
MSN Direct Services Classes