设备仿真程序命令行参考
更新：2007 年 11 月
使用下面的语法在命令提示符处启动设备仿真程序。除非使用 /s 或 @decfg_filename 命令行选项，否则 os_image_file_name 是必需的。
.gif "说明") 说明： |
|---|
有些 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 作为保存状态名称，并将保存状态文件放到每个用户的目录中。
|
||||
/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 开关的以下行为：
|
||||
/sharedfolderdirectoryname |
将一个目录作为共享文件夹装入，其中 directoryname 为 Windows 目录。该目录被作为来宾“\Storage File”装入，就像是一个存储卡。 |
||||
/skinskin_file_name |
加载指定的外观文件。
|
||||
/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。
|
||||
/vmid{GUID} |
指定要与仿真程序当前实例关联的 VMID GUID。它通常不在独立方案中传递。 如果没有 {GUID}，则会在不进行提示的情况下为该会话创建一个。 |
||||
/vmnamename |
指定窗口标题。注意下面的行为：
|
||||
/z |
将显示窗口（外观和 LCD 窗口）放大为正常大小的 2 倍。 |
||||
/speakerphone[n] |
指定是否存在话筒、耳机和/或车载。n 是一个介于 0 和 7 之间的位图化编号，它们的含义为：
|
.gif "安全说明")
安全说明：示例
下面的示例启动 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"