Funzioni dell'utilità della riga di comando DevCon come alternativa a Gestione periferiche

DevCon è un'utilità della riga di comando che rappresenta un'alternativa a Gestione periferiche. Consente di abilitare, disabilitare, riavviare, aggiornare, rimuovere ed eseguire query per periferiche singole o gruppi. Fornisce inoltre informazioni importanti per lo sviluppatore di driver non disponibili in Gestione periferiche.

È possibile utilizzare DevCon in Microsoft Windows 2000, Windows XP e Windows Server 2003, mentre non è possibile utilizzarla in Windows 95, Windows 98 o Windows Millennium Edition.

DevCon non è ridistribuibile. L'utilità viene fornita per essere utilizzata come strumento di debug e di sviluppo. Può essere modificata liberamente per uso privato. Nell'esempio viene illustrato come utilizzare le funzioni SetupAPI e CfgMgr32 insieme in modo efficace per enumerare periferiche ed eseguire operazioni relative. Il seguente file è disponibile per il download dall'Area download Microsoft (l'installazione è in inglese):

Download del pacchetto DevCon. Data di rilascio: 29 gennaio 2003

Per ulteriori informazioni sul download di file di supporto Microsoft, fare clic sul numero dell'articolo della Microsoft Knowledge Base riportato di seguito: Il file è stato controllato e non contiene virus. Microsoft ha utilizzato il software antivirus più recente disponibile al momento della data di pubblicazione del file. Il file viene salvato su server con un livello di protezione avanzata che impedisce modifiche non autorizzate.

Il file DevCon.exe contiene i seguenti file:

Nota Il codice sorgente di DevCon è disponibile anche nel DDK di Windows all'indirizzo http://www.microsoft.com/whdc/devtools/ddk/default.mspx in corrispondenza della cartella principale del DDK\Src\Setup\Devcon, con la documentazione.

Utilizzo di DevCon

DevCon è un'utilità della riga di comando con documentazione incorporata. Se si esegue il comando devcon help, verrà visualizzato l'elenco di comandi e descrizioni riportato di seguito. Il comando devcon help fornisce ulteriori informazioni dettagliate su qualsiasi comando. Con alcuni di questi comandi è possibile specificare un computer di destinazione remoto. Questi comandi funzionano se si utilizza la versione a 32 bit di DevCon in WOW64.

Esempi di comandi di DevCon

devcon -m:\\test find pci\*

Elenca tutte le periferiche PCI conosciute nel computer di verifica. Con-m è possibile specificare un computer di destinazione. Per accedere al computer, è necessario utilizzare la comunicazione interprocesso (IPC).

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

Consente di installare una nuova istanza della scheda Microsoft Loopback. In tal modo viene creato un nuovo nodo della periferica enumerata in base alla principale con il quale è possibile installare una "periferica virtuale" come la scheda Loopback. Questo comando consente inoltre di riavviare il computer senza avvisare in caso di necessità.

devcon classes

Consente di elencare tutte le classi di installazione note. L'output contiene il nome breve non localizzato, ad esempio "USB", e il nome descrittivo, ad esempio "Controller Universal Serial Bus".

devcon classfilter upper !filter1 !filter2

Consente di eliminare i due filtri specificati.

devcon classfilter lower !badfilter +goodfilter

Consente di sostituire "badfilter" con "goodfilter".

devcon driverfiles =ports

Consente di elencare i file associati a ciascuna periferica nella classe di installazione ports.

devcon disable *MSLOOP

Consente di disattivare tutte le periferiche con ID hardware che termina in "MSLOOP", compreso "*MSLOOP".

devcon drivernodes @ROOT\PCI_HAL\PNP0A03

Consente di elencare tutti i driver compatibili per la periferica ROOT\PCI_HAL\PNP0A03. Può essere utilizzato per determinare il motivo della scelta di un file inf di informazione di una periferica integrale, anziché di un file inf di terze parti.

devcon enable '*MSLOOP

Consente di abilitare tutte le periferiche con ID hardware "*MSLOOP". La virgoletta singola indica che l'ID hardware deve essere considerato letteralmente, in altri termini che l'asterisco ["*"] è realmente un asterisco e non un carattere jolly.

devcon find *

Consente di elencare le istanze di tutte le periferiche presenti nel computer locale.

devcon find pci\*

Consente di elencare tutte le periferiche PCI (Peripheral Component Interconnect) note che si trovano nel computer locale. Questo comando presuppone che una periferica sia di tipo PCI se l'ID hardware corrispondente è preceduto da "PCI\".

devcon find =ports *pnp*

Consente di elencare le periferiche presenti che fanno parte della classe di installazione ports e che contengono "PNP" nell'ID hardware.

devcon find =ports @root\*

Consente di elencare le periferiche presenti che fanno parte della classe di installazione ports e che si trovano nel ramo "root" della struttura enum e il cui ID istanza è preceduto da "root\". Si noti che non occorre fare alcuna supposizione programmatica sul modo in cui un ID istanza è formattato. Per determinare le periferiche principali, è possibile osservare i bit dello stato della periferica. Questa funzionalità è inclusa in DevCon per aiutare nel debug.

devcon findall =ports

Consente di elencare le periferiche non presenti e quelle presenti per la classe ports. Sono comprese le periferiche che sono state rimosse, quelle che sono state spostate da uno slot a un altro e, in alcuni casi, quelle che sono state enumerate in modo diverso a causa di una modifica del BIOS.

devcon listclass usb 1394

Consente di elencare tutte le periferiche presenti per ciascuna classe denominata, in questo caso USB e 1394.

devcon remove @usb\*

Consente di rimuovere tutte le periferiche USB. Le periferiche che vengono rimosse sono elencate con lo stato di rimozione.

devcon rescan

Consente di ripetere la verifica della presenza di nuove periferiche Plug and Play.

devcon resources =ports

Consente di elencare le risorse utilizzate da tutte le periferiche nella classe di installazione ports.

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

Consente di riavviare la scheda Loopback ROOT\*MSLOOP\0000. La virgoletta singola del comando indica che l'ID istanza deve essere considerato letteralmente.

devcon hwids=mouse

Consente di elencare tutti gli ID hardware delle periferiche di classe mouse presenti nel sistema.

devcon sethwid @ROOT\LEGACY_BEEP\0000 := beep

Consente di assegnare l'ID hardware, beep, alla periferica di segnalazione acustica precedente.

devcon stack =ports

Consente di elencare lo stack dei driver previsti per la periferica. Sono compresi i filtri superiori/inferiori delle periferiche e delle classi e il servizio di controllo.

devcon status @pci\*

Consente di elencare lo stato di ciascuna periferica presente che abbia un ID istanza che inizia con "pci\".

devcon status @ACPI\PNP0501\1

Consente di elencare lo stato di un'istanza di periferica specifica, in questo caso una porta seriale ACPI (Advanced Configuration and Power Interface).

devcon status @root\rdp_mou\0000

Consente di elencare lo stato del driver del mouse di Microsoft Terminal Server o dei Servizi terminal.

devcon status *PNP05*

Consente di elencare lo stato di tutte le porte COM.

devcon update mydev.inf *pnp0501

Consente di aggiornare tutte le periferiche che corrispondono esattamente all'ID hardware *pnp0501 affinché utilizzino il driver migliore in Mydev.inf associato all'ID hardware *pnp0501.

Nota Questo aggiornamento impone l'utilizzo del driver Mydev.inf per tutte le periferiche, anche se nel sistema è già presente una corrispondenza migliore. Ciò è utile quando si desidera installare nuove versioni dei driver durante lo sviluppo e prima di ottenere una firma. L'aggiornamento influisce solo sulle periferiche che corrispondono all'ID hardware specifico e non sulle periferiche figlio. Se il file inf specificato non contiene alcuna firma, in Windows potrebbe essere visualizzata una finestra di dialogo che richiede di confermare se il driver deve essere installato. Se è necessario un riavvio, tale operazione viene segnalata e DevCon restituisce un errore di livello 1. Se si specifica -r, si verifica un riavvio automatico in caso di necessità.

Note

• DevCon restituirà un livello di errore da utilizzare negli script:
  "0" indica un esito positivo.
  "1" indica che è necessario un riavvio.
  "2" indica un errore.
  "3" indica un errore di sintassi.
• Se si specifica -r ed è necessario un riavvio, questa operazione si verifica senza alcun avviso dopo l'elaborazione di tutte le periferiche.
• Se si specifica -m:\\computer e il comando non funziona per un computer remoto, verrà segnalato un errore.
• DevCon consente la presenza di caratteri jolly negli ID istanza per un uso interattivo. Non si faccia alcuna supposizione sul formato di un ID istanza da computer a computer e da una versione del sistema operativo all'altra.