OEMPreDownload (Windows Embedded CE 6.0)

1/5/2010

This function is called by the BLCOMMON framework prior to download and can be customized to prompt for user feedback, such as obtaining a static IP address or skipping the download and jumping to a flash-resident run-time image.

Syntax

DWORD OEMPreDownload (void);

Parameters

None.

Return Value

The return value for this function is usually obtained through a call to EbootInitEtherTransport, which collects this choice from Microsoft® Platform Builder. User selections for downloading or booting from a resident OS image are passed from Platform Builder to the boot loader through a call to EbootInitEtherTransport.

The following table shows the possible return values for OEMPreDownload.

Value Description

BL_DOWNLOAD = 0

Download the OS image from the host machine.

BL_JUMP = 1

Skip the download and jump to a resident OS image.

BL_ERROR = -1

Image download is unsuccessful.

Requirements

Header blcommon.h
Library blcommon.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Tasks

Implementing the OEMPreDownload Function

Reference

Boot Loader Control Flow Functions

Concepts

BLCOMMON Code Library