Freigeben über


Befehlszeilenreferenz zum Geräteemulator

Aktualisiert: November 2007

Starten Sie den Geräteemulator mithilfe der folgenden Syntax über die Befehlszeile. Der os_image_file_name ist erforderlich, sofern nicht die Befehlszeilenoption /s or @decfg_filename verwendet wird.

Hinweis:

In einigen SDKs werden nicht alle Optionen unterstützt. Weitere Informationen finden Sie in der SDK-Dokumentation.

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]

Parameter

Parameter

Beschreibung

os_image_file_name

Gibt den Pfad und Dateinamen (*.bin oder *.nb0) des Kernelabbilds an, das der Emulator verwenden soll.

Mit der Befehlszeilenoption /s können Sie den Geräteemulator über ein Kernelabbild, eine Geräteemulator-Konfigurationsdatei oder eine Datei mit gespeichertem Zustand starten.

@decfg_filename

Gibt den Pfad und Dateinamen der zu verwendenden Geräteemulator-Konfigurationsdatei (*.decfg) an.

Mit der Befehlszeilenoption /s können Sie den Geräteemulator über ein Kernelabbild, eine Geräteemulator-Konfigurationsdatei oder eine Datei mit gespeichertem Zustand starten.

Schalter

Schalter

Beschreibung

/a

Fixiert das Emulatorfenster im Vordergrund, auch wenn es nicht im Fokus ist.

/battery

Gibt frn Akkubetrieb an. Wenn die Option nicht angegeben ist, wird der Emulator standardmäßig auf Netzbetrieb festgelegt.

/batterycharge[n]

Gibt den Ladezustand des Akkus in n Prozent von 0-100 an. Wenn die Option nicht angegeben wird, wird standardmäßig eine Kapazität von 100 % festgelegt.

/c

Erstellt ein Konsolenfenster mit der Ausgabe vom seriellen Windows CE-Debug-Anschluss, über den Tastatureingaben des Benutzers übertragen werden, und zeigt es an. Diese Methode eignet sich insbesondere für das Beobachten der Debugausgabe und das Herunterladen von Kernelabbildern aus Platform Builder.

/cpucore

ARMv4 oder ARMv5. Der Standardwert ist ARMv4.

/cpuoptions

Eine Kombination aus (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. Die Optionen T, D und I werden immer festgelegt.

/defaultsave

Verwenden Sie die VMID als Namen für die Datei mit dem gespeicherten Zustand, und fügen Sie diese Datei in das jeweilige Benutzerverzeichnis ein.

Hinweis:
/defaultsave und /s können nicht gleichzeitig angegeben werden.

/funckey[value]

Dieser spezielle Schalter hat normalerweise den Wert 193. Bei Verwendung des Wertes 193 werden die Funktionstasten der Tastatur (F1, F2 usw.) den Bildschirmtasten eines Geräteemulators zugeordnet.

/flash[flash_file_name]

Aktiviert die Flashspeicheremulation, wobei optional flash_file_name den Namen der Datei angibt, die als Flashspeicher verwendet werden soll.

/h

Legt Nur-Host-Routing für Netzwerkpakete fest. Beeinflusst CS8900- und NE2000-Karten.

/hostkeykeyname

Gibt die Hosttaste an, wobei keyname ohne Beachtung der Groß-/Kleinschreibung None, Left-Alt oder Right-Alt sein kann.

/languageLangID

Gibt die Benutzeroberflächensprache an, wobei LangID eine vierstellige Dezimalzahl ist.

/memsizesize

Legt die Größe des emulierten Arbeitsspeichers fest, wobei size in Megabytes angegeben wird. Gültige Werte liegen im Bereich von 64 bis 256. Wenn kein gültiger Wert angegeben wird, wird size standardmäßig auf 64 festgelegt.

/n[macaddress]

Aktiviert den CS8900-Netzwerkadapter, wobei optional macaddress eine zwölfstellige hexadezimale Zahl ist, die angibt, an welchen Hostadapter die Karte gebunden wird.

/nosecurityprompt

Deaktiviert Aufforderungen zum Aktivieren von Netzwerkverbindungen, seriellen Anschlüssen und Ordnerfreigaben, wenn die Datei mit dem gespeicherten Zustand diese Features verwendet wird.

Sicherheitshinweis:
Die gemeinsame Verwendung von Ordnern stellt grundsätzlich ein potenzielles Sicherheitsrisiko dar. Sie sollten beispielsweise keine Verzeichnisse zur gemeinsamen Verwendung freigeben, die vertrauliche Informationen enthalten.

/p[macaddress]

Aktiviert den NE2000 PCMCIA-Netzwerkadapter, wobei optional macaddress eine zwölfstellige hexadezimale Zahl ist, die angibt, an welchen Hostadapter die Karte gebunden wird.

/rROM_address

Gibt die ROM-Dateibasisadresse an, wobei ROM_address eine hexadezimale oder dezimale Zahl sein kann.

/rotateangle

Dreht die Anzeige im Uhrzeigersinn um einen bestimmten Gradwert, wobei angle 0, 90, 180 oder 270 Grad sein kann. Es sind zwar auch andere ganze Zahlen zulässig, diese werden aber auf den nächsten 90-Grad-Wert abgerundet.

/sfilename

Aktiviert die Unterstützung für den gespeicherten Zustand, wobei filename der Name der Datei mit dem gespeicherten Zustand ist.

Sicherheitshinweis:
Die Verwendung von Dateien mit dem gespeicherten Zustand aus nicht vertrauenswürdigen Quellen kann ein Sicherheitsrisiko darstellen.

Beachten Sie die folgende Verhaltensweise für den /s-Schalter:

  • Wenn der Name einer ROM-Abbilddatei angegeben wurde, /sfilename jedoch nicht, führt der Emulator einen Kaltstart über das ROM-Abbild aus, und die Zustandsspeicherung ist deaktiviert.

  • Wenn der Name einer ROM-Abbilddatei und /sfilename angegeben wurden, führt der Emulator einen Kaltstart über das ROM-Abbild aus und aktiviert beim Beenden die Zustandsspeicherung, d. h., der Zustand wird unter dem angegebenen Dateinamen gespeichert.

  • Wenn kein ROM-Abbild angegeben wurde, wird /sfilename benötigt, und der Emulator führt anhand der Datei mit dem gespeicherten Zustand eine Wiederherstellung durch. Wenn der Emulator beendet wird, wird der neue Zustand über der Datei mit dem gespeicherten Zustand gespeichert.

    Hinweis:
    /defaultsave und /s können nicht gleichzeitig angegeben werden.

/sharedfolderdirectoryname

Stellt ein Verzeichnis als ein freigegebener Ordner bereit, wobei directoryname einem Windows-Verzeichnis entspricht. Das Verzeichnis wird als Gast-"\Speicherdatei" bereitgestellt, als würde es sich um eine Speicherkarte handeln.

/skinskin_file_name

Lädt die angegebene Designdatei.

Hinweis:
/skin und /video können nicht gleichzeitig angegeben werden.

/tooltipson|off

Aktiviert oder deaktiviert QuickInfos, wobei state entweder ON oder OFF sein kann.

/u0serialport

Ordnet den seriellen Anschluss 0 des Gastes (Emulator-COM1) dem serialport von Windows zu.

/u1serialport

Ordnet den seriellen Anschluss 1 des Gastes (Debugausgabe des Emulators) dem serialport von Windows zu.

/u2serialport

Ordnet den seriellen Anschluss 2 des Gastes (Emulator-COM3) dem serialport von Windows zu.

/vfptrue|false

Gibt an, dass ein VFP-Coprozessor (Vector Floating Point) vorhanden ist. Der Standardwert lautet false.

/video<width>x<height>x<bit-depth>

Gibt die Bildschirmgröße und die Bittiefe des LCD-Fensters an, wobei width, height und bit-depth Dezimalzahlen sind. Beispiel: 640x480x16.

Hinweis:
/skin und /video können nicht gleichzeitig angegeben werden.

/vmid{GUID}

Gibt die VMID-GUID an, die mit der aktuellen Instanz des Emulators verknüpft werden soll. Nicht üblich bei eigenständigen Szenarien.

Wenn keine {GUID} vorhanden ist, wird automatisch eine für die Sitzung erstellt.

/vmnamename

Gibt den Fenstertitel an. Beachten Sie folgendes Verhalten:

  • Wenn kein /vmid-Schalter, aber ein /skin-Schalter vorhanden ist, wird der Fenstertitel durch das Design vorgegeben.

  • Wenn weder ein /vmid-Schalter noch ein /skin-Schalter vorhanden ist, wird als Fenstertitel Geräteemulator angezeigt.

/z

Vergrößert die Anzeige (des Designs und des LCD-Fensters) auf das Zweifache der Normalgröße.

/speakerphone[n]

Gibt an, dass ein Freisprechtelefon, Headset und/oder Carkit vorhanden ist. n ist eine Bitmapzahl zwischen 0 und 7, die Folgendes angibt:

  • 0 – nichts

  • 1 – Carkit

  • 2 – Headset

  • 3 – Headset, Carkit

  • 4 – Freisprechtelefon

  • 5 – Freisprechtelefon, Carkit

  • 6 – Freisprechtelefon, Headset

  • 7 – Freisprechtelefon, Headset, Carkit

Beispiel

Im folgenden Beispiel wird der Windows Mobile 5.0 Pocket PC-Emulator gestartet:

Hinweis:

Das Emulator-Betriebssystemabbild befindet sich möglicherweise in einem anderen Ordner auf dem Computer.

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

Sie können im Menü Datei die Option Zustand speichern und beenden wählen und den Emulator mithilfe des folgenden Befehls über die Datei mit dem gespeicherten Zustand neu starten:

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

Im folgenden Beispiel wird der Geräteemulator über eine Geräteemulator-Konfigurationsdatei gestartet. Weitere Informationen finden Sie unter Geräteemulator-Konfigurationsdateien.

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

Siehe auch

Weitere Ressourcen

Referenz zum Geräteemulator