DBR701::UpgradeFirmware
.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 initiates a firmware upgrade on the MSN Direct receiver that starts in a separate thread.
Syntax
bool UpgradeFirmware(
TCHAR *fileName
);
Parameters
- fileName
[in] String that indicates the name of the file that contains the firmware upgrade for the MSN Direct receiver.
Return Value
Returns false if the file cannot be opened or if the new thread cannot be created; otherwise, returns true.
Remarks
Call this method to begin a firmware-upgrade operation.
This method first opens the file specified in the fileName parameter. If the file cannot be opened, the method aborts and returns false. Otherwise, this method begins the firmware upgrade in a new thread. If the new thread can be created, this method returns true.
After reboot, the receiver boot loader enters flash mode. The image file is a binary file prepared by Microsoft and is available on the Windows Embedded NavReady powered device.
When flashing is done, the receiver reboots and enters program mode. The Windows Embedded NavReady powered device must be restarted after the firmware-upgrade operation is complete. Call DBR701::FirmwareUpgradeCompletionPercentage to get firmware upgrade status completion.
Requirements
| Header | DBR701.h |
| Library | DBRLib.lib |
| Windows Embedded CE | Windows CE 5.0, Windows Embedded NavReady 2009 |
See Also
Reference
DBR701::FirmwareUpgradeCompletionPercentage
DBR701 Class
MSN Direct Services Classes