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.
.gif "Hinweis") 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. .gif "Sicherheitshinweis") 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:
|
/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:
|
/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:
|
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"