Emulator Command-Line Launch Options (Windows CE 5.0)

  • Article

Send Feedback

The Emulator_500.exe file is the executable file for the Emulator. The Emulator_500.exe file is under the top-level Platman directory for Platform Manager, in the Bin directory.

Note   The default path for the top-level Platform Manager directory is <Drive:>\Program Files\Common Files\Microsoft Shared\Windows CE Tools\Platman.

You can specify options in any order when you run the Emulator from the command line. Precede each option with a forward slash (/).

The following code example shows the syntax for running the Emulator from the command line.

Emulator_500 /CEImage Nk.bin /Video 800x600x16 /Ethernet virtualswitch

The following table shows the command-line options for Emulator_500.exe.

Option Description
/help Displays information about command-line options for the Emulator.
/hostkey <scancode> Specifies a key that you can use in a key combination to send keystrokes to the Emulator. When you use this key, the OS that hosts the Emulator does not receive keystrokes.

To specify a host key, provide a value that is equivalent to the AT keyboard scan code for the key. For information about the AT keyboard scan code for each key, see Emulator Host Key Options.
/video <width>x<height>x<depth>" Specifies a display resolution in pixels and color depth in bits for the Emulator.
/memorysize <number> Specifies, in MB, the amount of RAM to make available to the Emulator.
/ethernet <mode> Specifies the level of networking support in the Emulator.

Specify one of the following values:

  • none

    The Emulator does not support networking.

  • shared

    Outgoing NAT is enabled. The Emulator supports outgoing network connections only. Over an Ethernet connection, the Emulator cannot receive information that it did not request. In this mode, servers such as the FTP server and the Web server (HTTPD) do not work correctly. There may also be problems with connecting over a virtual private network (VPN) or connecting with Point-to-Point Tunneling Protocol (PPTP).

  • virtualswitch

    The Emulator uses the first Ethernet adapter that it finds on the development workstation. The Emulator supports incoming network connections.

  • <MAC address of Ethernet adapter>

    The Emulator uses the Ethernet adapter on the development workstation that has the specified MAC address. Specify the MAC address in XXXXXXXXXXXX format or in XX-XX-XX-XX-XX-XX format.
/serialport1 <mapping> Sets the properties of the first serial port for the Emulator.

Specify one of the following values:

  • COM1
  • COM2
  • COM3
  • COM4
  • file:<filename>
/serialport2 <mapping> Sets the properties of the second serial port for the Emulator.

Specify one of the following values:

  • COM1
  • COM2
  • COM3
  • COM4
  • file:<filename>
/parallelport <mapping> Specifies which parallel port on the development workstation the Emulator uses.

Specify one of the following values:

  • LPT1
  • LPT2
  • none
/skin <path> Specifies which Emulator skin to use with the Emulator.

Provide the file name for an .xml file that defines an Emulator skin. For more information about files for an Emulator skin, see Emulator Skin Files.
/sharedfolder <path> Specifies a directory on the development workstation to which the Emulator connects as if the directory were a drive mounted on the Emulator.

In the file system for the Emulator, the directory to which the Emulator connects appears at the root level as Storage Card. You can connect the Emulator to only one directory at a time.

For more information, see Mapping a Directory to the Emulator.
/ceimage <path> Specifies a Windows CE–based run-time image to load into the Emulator.
/vmid <GUID> Specifies a GUID for the Emulator session to create or the GUID of a previously saved session to restore.
/vmname <name> Specifies a name for the Emulator. The Emulator uses this name as the title of the Emulator window.
/forbidsave Prevents the user from saving the state of the Emulator by removing the option that saves the state of the Emulator from the Shut Down dialog box.
/nobootscreen Instructs the Emulator to not display a boot screen.
/regserver Registers the COM server in the Emulator.
/unregserver Removes registration of the COM server in the Emulator.
/fastbackground Runs the Emulator at foreground priority if the Emulator is in the background.

See Also

Emulator

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.