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.

Remarque :

Vous ne pouvez pas spécifier à la fois /defaultsave et /s.

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

Note de sécurité :

Toute utilisation de la fonctionnalité partage de dossier présente un problème potentiel de sécurité. Par exemple, n'activez pas le partage de répertoires qui contiennent des informations confidentielles ou sensibles.

/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é.

Note de sécurité :

L'utilisation de fichiers d'état enregistré à partir de sources non fiables peut poser un problème de sécurité.

Notez le comportement suivant du commutateur /s :

  • Si un nom du fichier d'image ROM est spécifié sans le commutateur /sfilename, l'émulateur démarre à froid à partir de l'image ROM et l'état enregistré est désactivé.

  • Si un nom de fichier d'image ROM est accompagné du commutateur /sfilename, l'émulateur démarre à froid à partir de l'image ROM et active l'état enregistré quand il s'arrête, l'état étant enregistré dans le fichier spécifié.

  • Si aucune image ROM n'est spécifiée, le commutateur /sfilename doit être présent, et l'émulateur effectue la restauration à partir du fichier d'état enregistré spécifié. Lorsque l'émulateur s'arrête, il enregistre le nouvel état en haut du fichier d'état enregistré.

    Remarque :

    Vous ne pouvez pas spécifier à la fois /defaultsave et /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é.

Remarque :

Vous ne pouvez pas spécifier à la fois /skin et /video.

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

Remarque :

Vous ne pouvez pas spécifier à la fois /skin et /video.

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

  • Si aucun commutateur /vmid n'est présent, mais que le commutateur /skin l'est, l'apparence fournit le titre de la fenêtre.

  • Si ni /vmid ni /skin ne sont présents, Microsoft Device Emulator constitue le titre de la fenêtre.

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

  • 0 – aucun matériel

  • 1 – kit de voiture

  • 2 - casque

  • 3 - casque, kit de voiture

  • 4 – haut-parleur

  • 5 – haut-parleur, kit de voiture

  • 6 – haut-parleur, casque

  • 7 – haut-parleur, casque, kit de voiture

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"

Voir aussi

Autres ressources

Référence de Device Emulator