设备仿真程序命令行参考

更新：2007 年 11 月

使用下面的语法在命令提示符处启动设备仿真程序。除非使用 /s 或 @decfg_filename 命令行选项，否则 os_image_file_name 是必需的。

说明：
有些 SDK 并不支持所有选项。有关更多信息，请参见 SDK 文档。

DeviceEmulator os_image_file_name [/a] [/c] [/f [featurevalue]]
   [/flash [flash_file_name]] [/h] [/hostkey keyname]
   [/language LangID] [/memsize size] [/n [macaddress]]
      [/nosecurityprompt] [/p [macaddress]] [/r ROM_address]
   [/rotate angle] [/s save-state_file_name]
   [/sharedfolder directoryname] [/skin skin_file_name] [/tooltips
        state] [/u0 serialport] [/u1 serialport] [/u2 serialport]
      [/video <width>x<height>x<bit depth>] [/vmid {GUID}]
   [/vmname name] [/z]

参数

参数	说明
os_image_file_name	指定仿真程序要使用的内核映像的路径和文件名称（*.bin 或 *.nb0）。 通过使用 /s 命令行选项，可以从内核映像、设备仿真程序配置文件或保存状态文件启动设备仿真程序。
@decfg_filename	指定要使用的设备仿真程序配置文件 (*.decfg) 的路径和文件名。 通过使用 /s 命令行选项，可以从内核映像、设备仿真程序配置文件或保存状态文件启动设备仿真程序。

开关

开关	说明
/a	即使没有焦点，也使仿真程序窗口始终保持在最前面。
/battery	指定电池电源。如果该选项不存在，则仿真程序默认为使用交流电源。
/batterycharge[n]	指定电池电量，以从 0 到 100 的百分比 n 表示。如果该选项不存在，则电量默认为 100%。
/c	创建并显示一个控制台窗口以显示 Windows CE 调试串行端口的输出内容，用户键入的击键正是传送到此控制台。该技术对于从 Platform Builder 观察调试输出和下载内核映像非常有用。
/cpucore	ARMv4 或 ARMv5。默认值为 ARMv4。
/cpuoptions	(T)humb、(D)ebug、(I)nternetworking、(M)Long Multiply、(e)DSP 的组合。在这些选项中，总是会设置 T、D 和 I。
/defaultsave	使用 VMID 作为保存状态名称，并将保存状态文件放到每个用户的目录中。 说明： 不能同时指定 /defaultsave 和 /s。
/funckey[value]	这是一个特殊的开关，其值通常为 193。使用值 193 会将键盘功能键（F1、F2 等）映射到设备仿真程序的软键。
/flash[flash_file_name]	启用闪存仿真，其中的可选 flash_file_name 指定要用作闪存存储的文件的名称。
/h	为网络数据包设置仅主机路由。影响 CS8900 和 NE2000 网卡。
/hostkeykeyname	指定主机键，其中的 keyname（区分大小写）可以是 None、Left-Alt 或 Right-Alt。
/languageLangID	指定 UI 语言，其中的 LangID 为四位数字的十进制数。
/memsizesize	设置仿真的 RAM 大小，其中 size 以 MB 为单位。有效值为从 64 到 256（含）。如果未指定有效值，则 size 默认为 64。
/n[macaddress]	启用 CS8900 网络适配器，其中可选的 macaddress 是一个十二位数字的十六进制数，指定卡将绑定到哪个主机适配器。
/nosecurityprompt	当已保存状态文件使用网络连接、串行端口和文件夹共享时，禁用启用它们的提示。 安全说明： 只要使用文件夹共享功能，就会带来潜在的安全风险。例如，对于包含保密或敏感信息的目录，请不要启用共享。
/p[macaddress]	启用 NE2000 PCMCIA 网络适配器，其中可选的 macaddress 是一个十二位数字的十六进制数，指定卡将绑定到哪个主机适配器。
/rROM_address	指定 ROM 文件基址，其中 ROM_address 可以是十六进制数或十进制数。
/rotateangle	按度数顺时针旋转显示屏，其中 angle 可以是 0、90、180 或 270。允许使用其他整数值，但是要四舍五入到最接近于 90 的整数倍数的值。
/sfilename	启用保存状态支持，其中 filename 是保存状态文件的名称。 安全说明： 使用来自不受信任来源的已保存状态文件会导致安全风险。 请注意 /s 开关的以下行为： 如果指定了 ROM 映像文件名但没有指定 /sfilename，则仿真程序会从 ROM 映像冷启动，并禁用保存状态。 如果指定了 ROM 映像文件名和 /sfilename，则仿真程序从 ROM 映像冷启动，并在退出时启用保存状态，将状态保存到指定的文件名。 如果没有指定 ROM 映像，则 /sfilename 必须存在，并且仿真程序将从指定的保存状态文件还原。当该仿真程序退出时，它会将新状态保存到保存状态文件的最前面。 说明： 不能同时指定 /defaultsave 和 /s。
/sharedfolderdirectoryname	将一个目录作为共享文件夹装入，其中 directoryname 为 Windows 目录。该目录被作为来宾“\Storage File”装入，就像是一个存储卡。
/skinskin_file_name	加载指定的外观文件。 说明： 不能同时指定 /skin 和 /video。
/tooltipson|off	启用或禁用工具提示，其中 state 为 ON 或 OFF。
/u0serialport	将来宾串行端口 0（仿真程序 COM1）映射到 Windows serialport。
/u1serialport	将来宾串行端口 1（仿真程序调试输出）映射到 Windows serialport。
/u2serialport	将来宾串行端口 2（仿真程序 COM3）映射到 Windows serialport。
/vfptrue|false	指定是否存在向量浮点协处理器。默认值为 false。
/video<width>x<height>x<bit-depth>	指定 LCD 窗口的屏幕大小和位深度，其中 width、height 和 bit-depth 为十进制值。例如：640x480x16。 说明： 不能同时指定 /skin 和 /video。
/vmid{GUID}	指定要与仿真程序当前实例关联的 VMID GUID。它通常不在独立方案中传递。 如果没有 {GUID}，则会在不进行提示的情况下为该会话创建一个。
/vmnamename	指定窗口标题。注意下面的行为： 如果 /vmid 开关不存在但 /skin 存在，则由外观提供窗口标题。 如果 /vmid 和 /skin 都不存在，则“设备仿真程序”显示为窗口标题。
/z	将显示窗口（外观和 LCD 窗口）放大为正常大小的 2 倍。
/speakerphone[n]	指定是否存在话筒、耳机和/或车载。n 是一个介于 0 和 7 之间的位图化编号，它们的含义为： 0 – 无 1 - 车载 2 - 耳机 3 - 耳机、车载 4 - 话筒 5 – 话筒、车载 6 – 话筒、耳机 7 – 话筒、耳机、车载

示例

下面的示例启动 Windows Mobile 5.0 Pocket PC 仿真程序：

说明：
仿真程序操作系统映像可能位于计算机上的另一个文件夹中。

DeviceEmulator.exe "c:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC
\Deviceemulation\0409\PPC_USA.BIN" /a /battery /batterycharge 40 
/cpucore ARMv5 /memsize 256 /s "d:\MyCustomEmulator.dess" /skin 
"c:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\
Pocket_pc\Pocket_PC.xml" /tooltips ON /vfp false 
/vmname "My Custom Emulator" /z /speakerphone 7

然后，可以从“文件”菜单上选择“保存状态并退出”，并使用下面的命令再次从保存的状态文件中启动仿真程序：

DeviceEmulator.exe /s "d:\MyCustomEmulator.dess"

下面的示例从设备仿真程序配置文件中启动设备仿真程序。有关更多信息，请参见设备仿真程序配置文件。

DeviceEmulator.exe "@c:\My Emulator.decfg"

请参见

其他资源

设备仿真程序参考