Référence de la ligne de commande Microsoft Device Emulator
Mise à jour : novembre 2007
Lancez Microsoft Device Emulator à partir d'une ligne de commande en utilisant la syntaxe ci-après. Le os_image_file_name est obligatoire à moins que vous n'utilisiez l'option de ligne de commande /s ou @decfg_filename.
Remarque : |
---|
Certains Kits de développement logiciel ne prennent pas en charge toutes les options. Pour plus d'informations, consultez la documentation relative au Kit de développement logiciel. |
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]
Paramètres
Paramètre |
Description |
---|---|
os_image_file_name |
Spécifie le chemin d'accès et le nom de fichier (* .bin ou * .nb0) de l'image de noyau utilisée par l'émulateur. Vous pouvez démarrer l'émulateur de périphérique à partir d'une image de noyau, d'un fichier de configuration de l'émulateur de périphérique ou d'un fichier d'état enregistré à l'aide de l'option de ligne de commande /s. |
@decfg_filename |
Spécifie le chemin d'accès et le nom du fichier de configuration de l'émulateur de périphérique (*decfg) à utiliser. Vous pouvez démarrer l'émulateur de périphérique à partir d'une image de noyau, d'un fichier de configuration de l'émulateur de périphérique ou d'un fichier d'état enregistré à l'aide de l'option de ligne de commande /s. |
Commutateurs
Commutateur |
Description |
||||
---|---|---|---|---|---|
/a |
Permet que la fenêtre de l'émulateur soit toujours visible, même lorsqu'elle n'a pas le focus. |
||||
/battery |
Spécifie l'alimentation par batterie. Si cette option est absente, l'émulateur fonctionne par défaut sur secteur. |
||||
/batterycharge[n] |
Spécifie le niveau de charge de la batterie sous forme d'un pourcentage n compris entre 0 et 100. Si cette option est absente, la valeur par défaut est 100 % |
||||
/c |
Crée et affiche une fenêtre de console pour afficher la sortie du port série de débogage Windows CE, où les séquences de touches tapées par l'utilisateur sont transmises. Cette technique est utile pour examiner la sortie de débogage et télécharger les images de noyau à partir de Platform Builder. |
||||
/cpucore |
ARMv4 ou ARMv5. La valeur par défaut est ARMv4. |
||||
/cpuoptions |
Combinaison de (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. Au nombre desquels, T,D,I sont toujours définis. |
||||
/defaultsave |
Utilisez le VMID comme nom d'état enregistré et placez le fichier d'état enregistré dans le répertoire de l'utilisateur.
|
||||
/funckey[value] |
Il s'agit d'un commutateur spécial ayant habituellement la valeur 193. Cette valeur mappe les touches de fonction du clavier (F1, F2, etc.) aux touches programmables d'un émulateur de périphérique. |
||||
/flash[flash_file_name] |
Active l'émulation de la mémoire flash où flash_file_name (facultatif) spécifie le nom du fichier à utiliser comme stockage de la mémoire flash. |
||||
/h |
Définit le routage invité uniquement pour les paquets réseau. Affecte les cartes CS8900 et NE2000. |
||||
/hostkeykeyname |
Spécifie la touche hôte où keyname (qui ne respecte pas la casse) peut être None, Left-Alt ou Right-Alt. |
||||
/languageLangID |
Spécifie la langue de l'interface utilisateur où LangID représente une valeur décimale sur quatre chiffres. |
||||
/memsizesize |
Définit la taille de la RAM émulée, où size est en mégaoctets. Les valeurs valides sont comprises entre 64 et 256 inclus. Si une valeur valide n'est pas spécifiée, size a la valeur 64 par défaut. |
||||
/n[macaddress] |
Active la carte réseau CS8900, où macaddress (facultatif) est un nombre hexadécimal de douze chiffres qui spécifie l'adaptateur hôte auquel la carte sera liée. |
||||
/nosecurityprompt |
Désactive les invites d'activation de la connectivité réseau, des ports série et du partage de dossier, quand le fichier d'état enregistré utilise ces fonctionnalités.
|
||||
/p[macaddress] |
Active la carte réseau PCMCIA NE2000, où macaddress (facultatif) est un nombre hexadécimal de douze chiffres qui spécifie l'adaptateur hôte auquel la carte sera liée. |
||||
/rROM_address |
Spécifie l'adresse de base du fichier ROM, où ROM_address peut être une valeur hexadécimale ou décimale. |
||||
/rotateangle |
Fait pivoter l'affichage par degrés (dans le sens des aiguilles d'une montre), où angle peut être 0, 90, 180 ou 270. D'autres valeurs entières sont autorisées, mais elles sont arrondies au multiple de 90 le plus proche. |
||||
/sfilename |
Active la prise en charge de l'état enregistré, où filename est le nom de fichier de l'état enregistré.
Notez le comportement suivant du commutateur /s :
|
||||
/sharedfolderdirectoryname |
Monte un répertoire comme dossier partagé, où directoryname est un répertoire Windows. Le répertoire est monté comme "\Fichier de stockage" invité, comme s'il s'agissait d'une carte de stockage. |
||||
/skinskin_file_name |
Charge le fichier d'apparence spécifié.
|
||||
/tooltipson|off |
Active ou désactive les info-bulles, où state est ON ou OFF. |
||||
/u0serialport |
Mappe le port série 0 invité (COM1 de l'émulateur) avec le serialport Windows. |
||||
/u1serialport |
Mappe le port série 1 invité (sortie de débogage de l'émulateur) avec le serialport Windows. |
||||
/u2serialport |
Mappe le port série 2 invité (COM3 de l'émulateur) avec le serialport Windows. |
||||
/vfptrue|false |
Spécifie la présence du coprocesseur VFP (Vector Floating Point). La valeur par défaut est false. |
||||
/video<width>x<height>x<bit-depth> |
Spécifie la dimension d'écran et la profondeur de couleur de la fenêtre LCD, où width, heightet bit-depth sont des valeurs décimales. Exemple : 640 x 480 x 16.
|
||||
/vmid{GUID} |
Spécifie le GUID VMID à associer à l'instance actuelle de l'émulateur. Commutateur peu utilisé dans les scénarios autonomes. Si aucun {GUID} n'est présent, il en est créé un pour la session de façon silencieuse. |
||||
/vmnamename |
Spécifie le titre de la fenêtre. Notez le comportement suivant :
|
||||
/z |
Effectue un zoom de l'affichage (apparence et fenêtre LCD) 2 fois plus grand que la taille normale. |
||||
/speakerphone[n] |
Spécifie la présence d'un haut-parleur, d'un casque et/ou d'un kit de voiture. n est un nombre bitmap compris entre 0 et 7 qui signifie :
|
Exemple
L'exemple suivant démarre Windows Mobile 5.0 Pocket PC Emulator :
Remarque : |
---|
L'image du système d'exploitation de l'émulateur peut être dans un dossier différent sur votre ordinateur. |
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
Vous pouvez sélectionner ensuite Enregistrer l'état et quitter dans le menu Fichier et redémarrer l'émulateur à partir du fichier d'état enregistré à l'aide de la commande suivante :
DeviceEmulator.exe /s "d:\MyCustomEmulator.dess"
L'exemple suivant démarre l'émulateur de périphérique à partir d'un fichier de configuration d'émulateur de périphérique. Pour plus d'informations, consultez Fichiers de configuration de Microsoft Device Emulator.
DeviceEmulator.exe "@c:\My Emulator.decfg"