Share via


EbootInitEtherTransport (Windows Embedded CE 6.0)

1/5/2010

This function initializes the Ethernet download transport.

Syntax

BOOL EbootInitEtherTransport(
  EDBG_ADDR* pEdbgAddr,
  LPDWORD pdwSubnetMask,
  BOOL* pfJumping,
  DWORD* pdwDHCPLeaseTime,
  UCHAR VersionMajor,
  UCHAR VersionMinor,
  char* szPlatformString,
  char* szDeviceName,
  UCHAR CPUId,
  DWORD dwBootFlags
);

Parameters

  • pEdbgAddr
    [in] Pointer to an EDBG_ADDR structure containing the IP address and Media Access Control (MAC) address of the device.

    The wPort field is not used.

  • pdwSubnetMask
    [in] Subnet mask.
  • pfJumping
    [in] Set to TRUE, if Eshell prompts a jump to the existing image.

    This value is returned from Platform Builder. BL_DOWNLOAD is returned by default, but BL_JUMP is returned, if the user selected Jump to Image in the integrated development environment (IDE).

  • pdwDHCPLeaseTime
    [in] This is an overloaded parameter. NULL means a static IP. Otherwise, the value is the Dynamic Host Configuration Protocol (DHCP) lease time.
  • VersionMajor
    [in] Version number. Part of the bootme packet.
  • VersionMinor
    [in] Version number. Part of the bootme packet.
  • szPlatformString
    [in] Root name of the platform string. For example, "XSC1BD1234" may be the device name and the platform string is "XSC1BD".
  • szDeviceName
    [in] Full name of the device with the MAC address randomization at the end. For example, "XSC1BD1234" is the full name that shows up in Platform Builder.
  • CPUId
    [in] CPU identifier, for example, EDBG_CPU_ARM720.

    See %_WINCEROOT%\Public\Common\Oak\Inc\Ethdbg.h for the list of CPU identifiers.

  • dwBootFlags
    [in] Set to zero.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

This function retrieves an IP address from a DHCP server, if necessary, and then initiates a Trivial File Transfer Protocol (TFTP) connection to Platform Builder on the development workstation.

Requirements

Header halether.h
Library hal.lib
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

Boot Loader Ethernet Controller Functions
EDBG_ADDR

Concepts

Eboot Code Library