Fonctions de l'utilitaire de ligne de commande DevCon comme alternative au Gestionnaire de périphériques

Traductions disponibles Traductions disponibles
Numéro d'article: 311272 - Voir les produits auxquels s'applique cet article
Cet article peut contenir des liens vers des informations en langue anglaise (pas encore traduites).
Agrandir tout | Réduire tout

Sommaire

Résumé

L'utilitaire DevCon est un utilitaire de ligne de commande qui peut être utilisé à la place du Gestionnaire de périphériques. Il vous permet d'activer, de désactiver, de redémarrer, de mettre à jour, de supprimer et d'interroger des périphériques individuels ou des groupes de périphériques. Il fournit également des informations utiles aux développeurs de pilotes, mais non disponibles dans le Gestionnaire de périphériques.

Vous pouvez utiliser DevCon avec Microsoft Windows 2000, Windows XP et Windows Server 2003. Vous ne pouvez pas utiliser DevCon avec Windows 95, Windows 98 ou Windows Millennium Edition.

Plus d'informations

Il est interdit de redistribuer DevCon. Il s'agit d'un outil de débogage et de développement. Vous pouvez librement modifier DevCon pour un usage personnel. L'exemple illustre comment utiliser conjointement les fonctions SetupAPI et CfgMgr32 pour énumérer les périphériques et effectuer des opérations sur les périphériques. Vous pouvez télécharger le fichier suivant à partir du Centre de téléchargement Microsoft :

Réduire cette imageAgrandir cette image
Télécharger
Télécharger le package DevCon maintenant. Date de publication : 29 janvier 2003

Pour plus d'informations sur la façon de télécharger des fichiers du Support technique Microsoft, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft.
119591 Comment obtenir des fichiers de support technique Microsoft auprès des services en ligne
Microsoft a analysé ce fichier en vue de détecter la présence de virus. Microsoft a utilisé les logiciels de détection de virus les plus récents disponibles à la date de publication de ce fichier. Le fichier est conservé sur des serveurs sécurisés, empêchant toute modification non autorisée du fichier.

Le fichier DevCon.exe contient les fichiers suivants :
Réduire ce tableauAgrandir ce tableau
FichierDescription
I386\DevCon.exeBinaire de l'outil DevCon à 32 bits. Il ne fonctionne pas complètement sur les systèmes d'exploitation Windows à 64 bits.
Ia64\DevCon.exeBinaire de l'outil DevCon à 64 bits.

Remarque Le code source de DevCon est également inclus dans le kit DDK de Windows (disponible sur le site Web http://www.microsoft.com/whdc/devtools/ddk/default.mspx (en anglais)) sous racine_DDK\Src\Setup\Devcon, avec la documentation.

Utilisation de DevCon

DevCon est un utilitaire de ligne de commande comprenant une documentation intégrée. Lorsque vous exécutez la commande devcon help, la liste de commandes et de descriptions ci-après s'affiche. La commande devcon help permet d'obtenir davantage d'aide sur une commande. Certaines de ces commandes vous permettent d'indiquer un ordinateur cible distant. Ces commandes fonctionnent avec la version 32 bits de DevCon sur WOW64.
Device Console Help:
devcon.exe [-r] [-m:\\<machine>] <command> [<arg>...]
-r if specified will reboot machine after command is complete, if needed.
<machine> is name of target machine.
<command> is command to perform (see below).
<arg>... is one or more arguments if required by command.
For help on a specific command, type: devcon.exe help <command>
classfilter          Allows modification of class filters.
classes              List all device setup classes.
disable              Disable devices that match the specific hardware or 
                       instance ID.
driverfiles          List driver files installed for devices.
drivernodes          Lists all the driver nodes of devices.
enable               Enable devices that match the specific hardware or 
                       instance ID.
find                 Find devices that match the specific hardware or 
                       instance ID.
findall              Find devices including those that are not present.
help                 Display this information.
hwids                Lists hardware ID's of devices.
install              Manually install a device.
listclass            List all devices for a setup class.
reboot               Reboot local machine.
remove               Remove devices that match the specific hardware or 
                       instance ID.
rescan               Scan for new hardware.
resources            Lists hardware resources of devices.
restart              Restart devices that match the specific hardware or 
                       instance ID.
stack                Lists expected driver stack of devices.
status               List running status of devices.
update               Manually update a device.
UpdateNI            Manually update a device without user prompt 
SetHwID              Adds, deletes, and changes the order of hardware IDs of root-enumerated devices.
		  				

Exemples de commandes DevCon

devcon -m:\\test find pci\*

Dresse la liste de tous les périphériques PCI connus présents sur l'ordinateur test (l'argument -m permet de spécifier un ordinateur cible ; vous devez utiliser la communication entre processus (IPC) pour pouvoir accéder à cet ordinateur).

devcon -r install %WINDIR%\Inf\Netloop.inf *MSLOOP

Installe une nouvelle instance de la carte de bouclage Microsoft. Cette commande crée un nouveau n?ud pour les périphériques énumérés à la racine, avec lequel vous pouvez installer un « périphérique virtuel », tel qu'une carte de bouclage. Elle redémarre également l'ordinateur en mode silencieux, si nécessaire.

devcon classes

Dresse la liste de toutes les classes de configuration connues. La sortie contient le nom court non traduit (« USB », par exemple) et le nom descriptif (« contrôleurs Universal Serial Bus », par exemple).

devcon classfilter upper !filter1 !filter2

Supprime les deux filtres spécifiés.

devcon classfilter lower !badfilter +goodfilter

Remplacez « badfilter » par « goodfilter ».

devcon driverfiles =ports

Dresse la liste des fichiers associés à chaque périphérique de la classe de configuration ports.

devcon disable *MSLOOP

Désactive tous les périphériques dont l'ID de matériel se termine par « MSLOOP » (y compris « *MSLOOP »).

devcon drivernodes @ROOT\PCI_HAL\PNP0A03

Dresse la liste de tous les pilotes compatibles avec le périphérique ROOT\PCI_HAL\PNP0A03. Cette commande peut servir à déterminer la raison pour laquelle un fichier .inf (Integral Device Information) a été préféré à un fichier .inf tiers.

devcon enable '*MSLOOP

Active tous les périphériques dont l'ID de matériel est « *MSLOOP ». Le guillemet simple indique qu'il faut considérer l'ID de matériel comme une expression littérale (en d'autres termes, l'astérisque [« * »] représente bien un astérisque ; il ne s'agit pas d'un caractère générique).

devcon find *

Dresse la liste de toutes les instances des périphériques présents sur l'ordinateur local.

devcon find pci\*

Dresse la liste de tous les périphériques PCI (Peripheral Component Interconnect) connus présents sur l'ordinateur local (cette commande suppose qu'un périphérique est de type PCI si son ID de matériel commence par « PCI\ »).

devcon find =ports *pnp*

Dresse la liste des périphériques présents appartenant à la classe de configuration ports et dont l'ID de matériel contient « PNP ».

devcon find =ports @root\*

Dresse la liste des périphériques présents appartenant à la classe de configuration ports et figurant à la racine de l'arborescence d'énumération (l'ID d'instance commence par « root\ »). Ne faites aucune supposition quant à la façon dont les ID d'instance sont mises en forme dans le code. Pour déterminer les périphériques à la racine, vous pouvez examiner les bits d'état des périphériques. Cette fonction est incluse dans DevCon pour faciliter le débogage.

devcon findall =ports

Dresse la liste de tous les périphériques absents et présents appartenant à la classe ports. Sont inclus les périphériques supprimés, les périphériques transférés dans un autre emplacement et, dans certains cas, les périphériques énumérés de façon différente en raison d'une modification du BIOS.

devcon listclass usb 1394

Dresse la liste de tous les périphériques présents pour chaque classe indiquée (dans cet exemple, USB et 1394).

devcon remove @usb\*

Supprime tous les périphériques USB. Les périphériques supprimés sont accompagnés de leur état de suppression.

devcon rescan

Effectue une nouvelle recherche sur les périphériques Plug and Play.

devcon resources =ports

Dresse la liste de toutes les ressources utilisées par tous les périphériques de la classe de configuration ports.

devcon restart =net @'ROOT\*MSLOOP\0000

Redémarre la carte de bouclage ROOT\*MSLOOP\0000. Le guillemet simple dans la commande indique qu'il faut considérer l'ID de matériel comme une expression littérale.

devcon hwids=mouse

Dresse la liste de tous les ID du matériel des périphériques de classe souris sur le système.

devcon sethwid @ROOT\LEGACY_BEEP\0000 := beep

Attribue l'ID de matériel, beep, au périphérique hérité beep.

devcon stack =ports

Indique la pile de pilotes attendue pour le périphérique. Elle inclut les filtres inférieurs/supérieurs de classes et de périphériques, ainsi que le service de contrôle.

devcon status @pci\*

Indique l'état de chaque périphérique présent dont l'ID d'instance commence par « pci\ ».

devcon status @ACPI\PNP0501\1

Indique l'état d'une instance de périphérique particulière ; dans cet exemple, il s'agit d'un port série énuméré par l'interface ACPI (Advanced Configuration and Power Interface).

devcon status @root\rdp_mou\0000

Indique l'état du pilote de souris de Microsoft Terminal Server ou des services Terminal Server.

devcon status *PNP05*

Indique l'état de tous les ports COM.

devcon update mydev.inf *pnp0501

Met à jour tous les périphériques correspondant exactement à l'ID de matériel *pnp0501 pour qu'ils utilisent le meilleur pilote possible dans Mydev.inf associé à l'ID de matériel *pnp0501.

Remarque Cette mise à jour force tous les périphériques à utiliser le pilote figurant dans Mydev.inf, même s'il existe déjà un meilleur choix sur le système. Cela peut être utile lorsque vous souhaitez installer de nouvelles versions de pilotes au cours d'une phase de développement, avant d'avoir obtenu une signature. La mise à jour ne concerne que les périphériques correspondant à l'ID de matériel spécifié, mais pas les périphériques enfants. Si le fichier .inf spécifié ne comporte pas de signature, il se peut que Windows affiche une boîte de dialogue vous invitant à confirmer s'il faut installer le pilote. S'il est nécessaire de redémarrer l'ordinateur, vous en êtes averti et DevCon renvoie une erreur de niveau 1. Si vous spécifiez l'argument -r, le redémarrage se fait automatiquement, le cas échéant.

Remarques

  • DevCon renvoie des erreurs de différents niveaux pour les scripts :
    « 0 » indique le succès de l'opération.
    « 1 » indique qu'un redémarrage est nécessaire.
    « 2 » indique l'échec de l'opération.
    « 3 » indique une erreur de syntaxe.
  • Si vous spécifiez l'argument -r et qu'un redémarrage est nécessaire, le redémarrage se fait automatiquement sans aucun avertissement, une fois tous les périphériques traités.
  • Si vous spécifiez la commande -m:\\ordinateur pour un ordinateur distant, une erreur est signalée.
  • Pour plus de commodité, DevCon autorise les caractères génériques dans les ID d'instance. Ne faites aucune supposition quant au format d'une ID d'instance entre différents ordinateurs ou différentes versions des systèmes d'exploitation.

Propriétés

Numéro d'article: 311272 - Dernière mise à jour: vendredi 23 mars 2007 - Version: 5.0
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Win32 Device Driver Kit for Windows 2000
  • Microsoft Windows XP Driver Development Kit
  • Microsoft Windows Server 2003 Driver Development Kit
Mots-clés : 
kbfile kbhowto KB311272
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com