Creating an Installation CD

To create an installation compact disc (CD) for your application, you must copy the following files to the CD:

Writing an Autorun script

The syntax of the AutoRun.inf file is similar to win32 desktop systems, but uses an Auto PC-specific section header to allow one piece of installation media to contain autorun components for both desktop operating systems and the Auto PC. To include desktop support, use the standard desktop sections like [autorun].

You need to place an Autorun.inf file in the root of the installation media (CD or CompactFlash™ card). Microsoft® Windows® CE for the Auto PC looks at the following section names of the autorun.inf file:

[AutoPC]
[AutoPC.shx]
[AutoPC.intel]
[AutoPC.mips]
[AutoPC.ppc]
[AutoPC.arm]

The [AutoPC]and [AutoPC.shx] section names are only supported for version 1.0, because all Auto PCs contain a Hitachi SH3 processor for version 1.0.

If a section for the specific Auto PC device processor can be found, it is used and all others are ignored. If there isn't a matching section for the specific processor family, the generic [AutoPC] section is used.

For example, the Clarion Auto PC uses a Hitachi SH3 processor which is part of the SHx processor family. If present, the [AutoPC.shx] section is used when installing to Clarion's Auto PC.

You can include the following items within each section:

Function
Description
open=command line with arguments If you include the open command line, it is passed to the ShellExecute function and all other lines are ignored. If the command line contains an absolute path to a file to be executed — that is, the command line begins with a backslash — the command line is passed unchanged to the ShellExecuteEx function. If not, the path to the autorun.inf is prepended onto the command line before passing it to ShellExecuteEx. This behavior allows you to execute documents located on your media without having to know whether the media is named "\storage card" or "\storage card2" or "\cd dash". If you try to run an EXE or a shortcut, the user is presented with a security warning dialog asking the user to confirm that they want to run it.

If you do not include an open command line, a menu is built with the remaining lines.

title=menu caption Optional. Specifies the title for the menu.
ItemX=menu display text * Optional. Displays a text string for the menu selection. If itemX is not provided, the openX line is displayed.
OpenX=menu command line with arguments * Specifies which file to open when the menu item is selected.
* X can be any number greater than or equal to one, but for memory efficiency reasons X should be kept as small as possible.

    To install your application .cei file

  1. Place your application’s .cei file in the root directory on your installation media.
  2. Create an Autorun.inf file.
  3. Under the appropriate autorun sections, include an open command line containing a pointer to your application’s .cei file.

The following example shows an Autorun.inf file that automatically starts the installation of a CEI file:

[AutoPC.shx]
open=example1.cei

The following example shows how to put more than one .cei file installation file on the same installation media:

[AutoPC.shx]
title=MS Arcade
item1=Blackjack
open1=blackjack.cei
item2=Roulette
open2=roulette.cei
item3=Crazy Eights
open3=crazy8.cei

    To create nested menus

  1. Place your application .cei files in subdirectories on your installation media.
  2. Place an Autorun.inf file for each application in each subdirectory on your installation media.
  3. Create a root Autorun.inf file that creates a menu to the other autorun.inf files.

The following example shows an Autorun.inf file that calls another Autorun.inf file.

[AutoPC]
title=Microsoft Sampler
item1=Arcade
open1=arcade\autorun.inf
item2=Return of Arcade
open2=retarcade\autorun.inf

The following example shows the Autorun.inf file that is located in the \arcade sub-directory of the installation media: It also shows how to provide multiple processor support on your installation media and have autorun automatically install the correct CEI for the user’s Auto PC device. The autorun code checks for SHx, Intel®, Mips and ARM processor types.

[AutoPC.shx]
title=Arcade
item1=Blackjack
open1=shx\blackjack.cei
item2=Roulette
open2=shx\roulette.cei

[Auto PC.intel]
title=Arcade
item1=Blackjack
open1=intel\blackjack.cei
item2=Roulette
open2=intel\roulette.cei

This autorun.inf file presents the user with a menu where they can go to the Arcade or Return of Arcade menu. If they choose Arcade, the arcade\autorun.inf is run and they see its menu. The user can press the BACK key to return to the main menu.