共用方式為


裝置模擬器命令列參考

更新: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

將模擬器視窗保持為最上層顯示,即使視窗沒有焦點 (Focus)。

/battery

指定電池電源。如果不存在這個選項,模擬器的預設值為 AC 電源。

/batterycharge[n]

以 0-100 的百分比 n 指定電池計量。如果不存在這個選項,計量的預設值為 100%。

/c

建立與顯示主控台視窗,顯示來自 Windows CE 偵錯序列埠的輸出,在此處會傳輸由使用者所輸入的按鍵動作。此一技巧在監看偵錯輸出,以及從 [平台產生器] 下載核心映像時很有幫助。

/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 記憶體模擬,其中選擇性的 flash_file_name 會指定做為 Flash 記憶體儲存的檔案名稱。

/h

設定網路封包的主機專用路由。影響 CS8900 與 NE2000 介面卡。

/hostkeykeyname

指定主機鍵,其中不區分大小寫的 keyname 可為 NoneLeft-AltRight-Alt

/languageLangID

指定 UI 語言,其中 LangID 為四位數十進位數字。

/memsizesize

設定模擬的 RAM 大小,其中 size 是以 MB 為單位。有效值是從 64 到 256 (包含 64 與 256)。如果未指定有效值,size 預設值為 64。

/n[macaddress]

啟用 CS8900 網路介面卡,其中選擇性的 macaddress 是 12 位數的十六進位數字,用來指定介面卡將要繫結的主機介面卡。

/nosecurityprompt

在儲存狀態檔使用這些功能時,停用提示以啟用網路連接、序列埠,以及檔案共用。

安全性注意事項:

任何使用資料夾共用功能的動作都可能會造成潛在的安全性風險。例如,請不要將包含機密或敏感資訊的目錄開放共用。

/p[macaddress]

啟用 NE2000 PCMCIA 網路介面卡,其中選擇性的 macaddress 是 12 位數的十六進位數字,用來指定介面卡將要繫結的主機介面卡。

/rROM_address

指定 ROM 檔案的基底位址 (Base Address),其中 ROM_address 可為十六進位或十進位。

/rotateangle

根據度數順時針旋轉顯示,其中 angle 可為 0、90、180 或 270。其他整數值也可使用,但是會進位至最接近的 90 的倍數。

/sfilename

啟用儲存狀態支援,其中 filename 為儲存狀態檔名。

安全性注意事項:

使用來自不受信任來源的儲存狀態檔案可能會造成安全性的風險。

請注意下列 /s 參數的行為:

  • 如果指定了 ROM 映像的檔名,但是沒有 /sfilename,模擬器會從 ROM 映像冷開機並停用儲存狀態。

  • 如果指定了 ROM 映像檔名和 /sfilename,模擬器會從 ROM 映像冷開機,並在結束時啟用儲存狀態,將狀態儲存到指定的檔名。

  • 如果未指定 ROM 映像,就必須有 /sfilename,而且模擬器會從指定的儲存狀態檔案還原。當模擬器結束時,會在儲存狀態檔案上儲存新狀態。

    注意事項:

    您無法同時指定 /defaultsave/s

/sharedfolderdirectoryname

將目錄掛上 (Mount) 為共用資料夾,其中 directoryname 為 Windows 目錄。目錄被視為如同儲存卡,掛上為 Guest "\Storage File"。

/skinskin_file_name

載入指定的面板檔案。

注意事項:

您無法同時指定 /skin/video

/tooltipson|off

啟用或停用工具提示,其中 state 為 ONOFF

/u0serialport

將 Guest 序列埠 0 (模擬器 COM1) 對應至 Windows serialport。

/u1serialport

將 Guest 序列埠 1 (模擬器偵錯輸出) 對應至 Windows serialport。

/u2serialport

將 Guest 序列埠 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},則會以無訊息模式為工作階段 (Session) 建立一個。

/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"

請參閱

其他資源

裝置模擬器參考