共用方式為

裝置模擬器組態 XML 結構描述參考

  • 發行項

更新：2007 年 11 月

裝置模擬器組態 (.decfg) 檔是包含裝置模擬器之啟動方式設定的 XML 檔。您可以在 .decfg 檔中進行如作業系統映像、面板、LCD 螢幕解析度及網路的設定。如需一般資訊，請參閱裝置模擬器組態檔。請使用下列範例做為撰寫 .decfg 檔的參考。

程式碼

<?xml version="1.0"?>
<DeviceEmulator xmlns="https://schemas.microsoft.com/DeviceEmulator/2006/01/DeCfg">
  <Platform>My Plaform</Platform>
  <Emulator>
    <Language Reconfigurable="false">1033</Language>
    <AlwaysOnTop Reconfigurable="true">true</AlwaysOnTop>
    <ConsoleWindow Reconfigurable="false">true</ConsoleWindow>
    <HostKey Reconfigurable="true">Left-Alt</HostKey>
    <Rotation Reconfigurable="true">270</Rotation>
    <VMID Reconfigurable="false">{B89C49AD-197F-4CB4-A525-D81D0944EEAF}</VMID>
    <VMName Reconfigurable="true">My Custom Emulator</VMName>
    <!--<SaveState Reconfigurable="false">c:\1.dess</SaveState>-->
    <DefaultSave Reconfigurable="false">true</DefaultSave>
    <Zoom Reconfigurable="true">true</Zoom>
    <Video Reconfigurable="false" Width="640" Height="480" BitsPerPixel="16"/>
    <FuncKey Reconfigurable="true">193</FuncKey>
    <!--<Skin Reconfigurable="true" EnableSkin="true" ToolTips="on">c:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\Pocket_pc\Pocket_PC.xml</Skin>-->
  </Emulator>
  <Board>
    <OSImage Reconfigurable="false" Address="0">d:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\0409\PPC_USA.BIN</OSImage>
    <Flash Reconfigurable="false" Enabled="true">c:\Flashfile</Flash>
    <MemSize Reconfigurable="false">256</MemSize>
    <CpuCore Reconfigurable="false">ARMv5</CpuCore>
    <CpuOptions Reconfigurable="false">TDI</CpuOptions>
    <VFP Reconfigurable="false">true</VFP>
  </Board>
  <Peripherals>
    <Battery Reconfigurable="true" IsOnAcPower="false" Charge="40"/>
    <SharedFolder Reconfigurable="true">c:\</SharedFolder>
    <CS8900_Networking Reconfigurable="false" Enabled="true">00001A1A190B</CS8900_Networking>
    <NE2000_Networking Reconfigurable="true" Enable="true">00001A1A190B</NE2000_Networking>
    <HostOnly Reconfigurable="true">true</HostOnly>
    <Speakerphone Reconfigurable="true" CarKit="true" Headset="true" Speakerphone="true"/>
    <SerialPort Reconfigurable="true" UARTNumber="0">COM3</SerialPort>
    <SerialPort Reconfigurable="true" UARTNumber="1">none</SerialPort>
    <SerialPort Reconfigurable="true" UARTNumber="2">none</SerialPort>
  </Peripherals>
</DeviceEmulator>

備註

下表說明上一個程式碼範例中的每個項目。

項目

說明

<DeviceEmulator> tag

封裝裝置模擬器組態的結構描述。在每個 .decfg 檔中都只能使用一個標記 (Tag)。包含下列標記：

  • Platform

  • Emulator

  • Board

  • Peripherals

<Platform>My Plaform</Platform>

包含平台的名稱。在每個 <DeviceEmulator> 標記都只使用一個 <Platform> 標記。[裝置模擬器管理員] 中的可見模擬器，都以平台標記中的值所組織。

<Emulator> tag

包含下列標記：

  • Language

  • AlwaysOnTop

  • ConsoleWindow

  • HostKey

  • Rotation

  • VMID

  • VMName

  • SaveState

  • DefaultSave

  • Zoom

  • Video

  • FuncKey

  • Skin

<Language Reconfigurable="false">1033</Language>

指定使用者介面 (UI) 語言，其中的值是四位數的十進位數字。例如，1033 代表美國英文。

<AlwaysOnTop Reconfigurable="true">true</AlwaysOnTop>

將模擬器視窗保持為最上層顯示，即使視窗沒有焦點 (Focus)。可以是 true 或 false。預設值為 false。

<ConsoleWindow Reconfigurable="false">true</ConsoleWindow>

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

<HostKey Reconfigurable="true">Left-Alt</HostKey>

指定主機鍵，其中不區分大小寫的值可為 None、Left-Alt 或 Right-Alt。

<Rotation Reconfigurable="true">270</Rotation>

依度數朝順時針方向旋轉顯示，其中的角度值可為 0、90、180 或 270。也接受其他的整數值，不過會捨入為最接近的 90 倍數。

<VMID Reconfigurable="false">{B89C49AD-197F-4CB4-A525-D81D0944EEAF}</VMID>

會指定 VMID GUID，以建立與模擬器目前執行個體的關聯。

<VMName Reconfigurable="true">My Custom Emulator</VMName>

指定視窗標題。如果不存在這個標記，視窗便會依據面板標記而命名，或是使用「裝置模擬器」的預設名稱。

<!--<SaveState Reconfigurable="false">c:\1.dess</SaveState>-->

啟用儲存狀態支援，其中的值為儲存狀態檔名。.decfg 檔必須指定 SaveState 或 OSImage 標記。請注意 SaveState 標記的下列性質：

  • 如果 SaveState 標記不存在，而卻有 OSImage 標記，模擬器便會從 OSimage 的值冷開機，並會停用儲存狀態。

  • 如果 SaveState 標記和 OSImage 標記存在，模擬器便會從 OSimage 標記的值冷開機、在結束時啟用儲存狀態，並將狀態儲存為指定的檔名。

  • 如果 SaveState 標記存在，OSImage 標記卻不存在，模擬器便會從指定的儲存狀態檔還原。當模擬器結束時，便會儲存新的狀態以覆寫儲存的狀態檔。

    注意事項：

    在此範例中，SaveState 標記是註解的一部分，這是因為 .decfg 檔無法同時指定 SaveState和 defaultsave標記。

<DefaultSave Reconfigurable="false">true</DefaultSave>

當值為 true 時，裝置模擬器便會使用 VMID 做為儲存狀態檔的名稱，並將儲存狀態檔放在個別使用者目錄中。可以是 true 或 false。

注意事項：

您不能在相同的 .decfg 檔中同時指定 SaveState標記和 defaultsave標記。

<Zoom Reconfigurable="true">true</Zoom>

將顯示 (面板與 LCD 視窗) 放大為正常大小的 2 倍。可以是 true 或 false。

<Video Reconfigurable="false" Width="640" Height="480" BitsPerPixel="16"/>

指定 LCD 視窗的螢幕大小和位元深度，其中 width、height 和 BitsPerPixel 屬性 (Attributes) 都是整數。

注意事項：

您不能在相同的 .decfg 檔中同時指定 Skin 和 Video 標記。

<FuncKey Reconfigurable="true">193</FuncKey>

這是特殊的標記，通常具有 193 的值。193 的值會使鍵盤功能鍵 (F1、F2 及其他等等) 對應至裝置模擬器的螢幕按鍵。

<!--<Skin Reconfigurable="true" EnableSkin="true" ToolTips="on">c:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\Pocket_pc\Pocket_PC.xml</Skin>-->

載入指定的面板檔案。

注意事項：

在此範例中，Skin 標記是註解的一部分，這是因為 .decfg 檔無法同時指定 Skin 和 Video 標記。

<Board> tag

包含下列標記：

  • OSImage

  • Flash

  • MemSize

  • CpuCore

  • CpuOptions

  • VFP

<OSImage Reconfigurable="false" Address="0">d:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\0409\PPC_USA.BIN</OSImage>

指定模擬器所使用之 OSimage 的路徑和檔名 (*.bin 或 *.nb0)。除非 SaveState 標記存在，否則此標記是必要的。

<Flash Reconfigurable="false" Enabled="true">c:\flash.txt</Flash>

啟用 Flash 記憶體模擬，其中的值會指定做為 Flash 記憶體儲存的檔案名稱。

<MemSize Reconfigurable="false">256</MemSize>

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

<CpuCore Reconfigurable="false">ARMv5</CpuCore>

指定所要模擬的 CPU 架構。可以是 ARMv4 或 ARMv5。預設值為 ARMv4

<CpuOptions Reconfigurable="false">TDI</CpuOptions>

指定 (T)humb、(D)ebug、(I)nternetworking、(M)Long Multiply、(e)DSP 的組合。其中，永遠都會設定 T、D 和 I。

<VFP Reconfigurable="false">true</VFP>

指定向量浮點副處理器的存在。可以是 true 或 false。預設值為 false。

<Peripherals> tag

包含下列標記：

  • Battery

  • SharedFolder

  • CS8900_Networking

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • SerialPort

<Battery Reconfigurable="true" IsOnAcPower="false" Charge="40"/>

指定電池電源和計量。IsOnAcPower 屬性會指定模擬器是以電池或 AC 電源執行。如果是以電池電源執行，charge 屬性便會以百分比指定計量。預設值為 AC 電源。

<SharedFolder Reconfigurable="true">c:\</SharedFolder>

將目錄掛上 (Mount) 為共用資料夾，其中的值為 Windows 目錄。在掛上目錄時，會將其視為儲存卡。

<CS8900_Networking Reconfigurable="false" Enabled="true">00001A1A190B</CS8900_Networking>

啟用 CS8900 網路介面卡，其中的選擇性值為十二位數的十六進位 MAC 位址，用來指定所要繫結之桌上型電腦中的主機介面卡。

<NE2000_Networking Reconfigurable="true" Enable="true">00001A1A190B</NE2000_Networking>

啟用 NE2000 PCMCIA 網路介面卡，其中的選擇性值為十二位數的十六進位 MAC 位址，用來指定所要繫結之桌上型電腦中的主機介面卡。

<HostOnly Reconfigurable="true">true</HostOnly>

設定網路封包的主機專用路由。影響 CS8900 與 NE2000 介面卡。可以是 true 或 false。預設值為 false。

<Speakerphone Reconfigurable="true" CarKit="true" Headset="true" Speakerphone="true"/>

  • 指定通話器、耳機和 (或) 車用套件的存在。

<SerialPort Reconfigurable="true" UARTNumber="0">COM3</SerialPort>

<SerialPort Reconfigurable="true" UARTNumber="1">COM2</SerialPort>

<SerialPort Reconfigurable="true" UARTNumber="2">none</SerialPort>

將模擬器序列埠對應至 Windows COM 連接埠。UARTNumber 屬性會指出模擬器上的連接埠號碼 0-2。該值指定桌上型電腦中的 COM 連接埠。在 .decfg 檔中可以使用這個標記多達三次，也就是針對模擬器上的三個序列埠各用一次。

Reconfigurable="true"

表示只要裝置模擬器依然在執行中，便能重新設定與這個標記關聯的功能。您可以重新設定該功能，而不需要結束或重新啟動模擬器。您可以重新設定下列標記：

  • AlwaysOnTop

  • HostKey

  • Rotation

  • VMName

  • Zoom

  • FuncKey

  • Skin

  • Battery

  • SharedFolder

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • Serialport

Reconfigurable="false"

表示只要裝置模擬器依然在執行中，便無法重新設定與這個標記關聯的功能。您必須在啟動模擬器期間指定此功能。您不可以重新設定下列標記：

  • Language

  • ConsoleWindow

  • VMID

  • SaveState

  • DefaultSave

  • Video

  • OSImage

  • Flash

  • MemSize

  • CpuCore

  • CpuOptions

  • VFP

  • CS8900_Networking

請參閱

概念

裝置模擬器組態檔

裝置模擬器管理員

參考

裝置模擬器命令列參考