Uso delle funzioni di installazione del dispositivo
Questa sezione riepiloga le funzioni di installazione del dispositivo. Usando le funzioni di installazione del dispositivo, il software di installazione può eseguire i tipi di operazioni seguenti:
Installare i driver
Gestire i codici DIF.
Gestire i set di informazioni sul dispositivo.
Gestire gli elenchi dei driver.
Gestire le interfacce del dispositivo.
Gestire le icone e altre bitmap.
Le tabelle seguenti forniscono riepiloghi dei tipi di funzioni seguenti:
Funzioni di installazione driver
Funzioni informazioni sul dispositivo
Gestori di installazione dei dispositivi
Funzioni di personalizzazione dell'installazione del dispositivo
Funzioni della classe Di installazione
Funzioni dell'interfaccia del dispositivo
Funzioni delle proprietà del dispositivo (Windows Vista e versioni successive)
Funzioni del Registro di sistema
Funzioni di installazione driver
Installa un pacchetto driver specificato preinstallato nell'archivio driver in un dispositivo PnP presente nel sistema. (Windows Vista e versioni successive di Windows) |
|
Disinstalla un dispositivo e rimuove il nodo del dispositivo (devnode) dal sistema. (Windows 7 e versioni successive di Windows) |
|
Preinstalla un pacchetto driver nell'archivio driver e quindi installa il pacchetto driver nei dispositivi PnP corrispondenti presenti nel sistema. (Windows Vista e versioni successive di Windows) |
|
Rimuove un pacchetto driver dall'Archivio driver. (Windows 10 versione 1703 e versioni successive di Windows) |
|
Aggiornamenti il pacchetto driver installato per i dispositivi PnP corrispondenti presenti nel sistema. |
|
Esegue il rollback del pacchetto driver installato in un dispositivo specificato nel pacchetto driver di backup impostato per il dispositivo. (Windows Vista e versioni successive di Windows) |
Funzioni informazioni sul dispositivo
Nota
SetupApi non è supportato in tutte le edizioni di Windows. Quando possibile, è consigliabile usare API di livello inferiore, ad esempio quelle disponibili tramite CfgMgr32.dll. Per suggerimenti, vedere Conversione da SetupApi a CfgMgr32 .
Crea un set di informazioni sul dispositivo vuoto. Questo set può essere associato a un GUID di classe. |
|
Crea un set di informazioni sul dispositivo vuoto. Questo set può essere associato a un GUID di classe e può essere per i dispositivi in un computer remoto. |
|
Crea un nuovo elemento informazioni dispositivo e lo aggiunge come nuovo membro al set di informazioni del dispositivo specificato. |
|
Recupera informazioni su un'istanza di dispositivo esistente e la aggiunge al set di informazioni sul dispositivo specificato. |
|
Restituisce una struttura di contesto per un elemento informativo del dispositivo di un set di informazioni sul dispositivo. |
|
Recupera l'ID istanza del dispositivo associato a un elemento informazioni del dispositivo. |
|
Recupera il GUID di classe associato a un set di informazioni sul dispositivo se ha una classe associata. |
|
Recupera informazioni associate a un set di informazioni sul dispositivo, tra cui il GUID di classe, l'handle del computer remoto e il nome del computer remoto. |
|
Recupera gli handle nei fogli delle proprietà di un elemento informativo del dispositivo specificato o della classe di installazione del dispositivo di un set di informazioni del dispositivo specificato. |
|
Restituisce un set di informazioni sul dispositivo che contiene tutti i dispositivi di una classe specificata. |
|
Restituisce un set di informazioni sul dispositivo che contiene tutti i dispositivi di una classe specificata in un computer locale o remoto. |
|
Imposta l'elemento informazioni sul dispositivo specificato per essere il membro attualmente selezionato di un set di informazioni sul dispositivo. Questa funzione viene in genere usata da un'installazione guidata. |
|
Recupera il dispositivo attualmente selezionato per il set di informazioni sul dispositivo specificato. |
|
Registra un'istanza del dispositivo appena creata con la gestione Plug and Play. |
|
Elimina un membro dal set di informazioni del dispositivo specificato. Questa funzione non elimina il dispositivo effettivo. |
|
Elimina un set di informazioni sul dispositivo e libera tutta la memoria associata. |
Funzioni informazioni driver
Compila un elenco di driver associati a un'istanza di dispositivo specificata o all'elenco di driver di classe globale del set di informazioni del dispositivo. |
|
Enumera i membri di un elenco di informazioni sui driver. |
|
Recupera informazioni dettagliate per un elemento informativo del driver specificato. |
|
Imposta il membro specificato di un elenco driver come driver attualmente selezionato. Può essere usato anche per reimpostare l'elenco dei driver in modo che non sia presente alcun driver attualmente selezionato. |
|
Recupera il membro di un elenco di driver selezionato come driver da installare. |
|
Annulla una ricerca elenco driver attualmente in corso in un thread diverso. |
|
Elimina un elenco di informazioni sui driver. |
Gestori di installazione dei dispositivi
Chiama il programma di installazione della classe appropriato e tutti i coinstallazioni registrati, con la richiesta di installazione specificata. |
|
Gestore predefinito per la richiesta di DIF_PROPERTYCHANGE. Può essere usato per modificare lo stato di un dispositivo installato. |
|
Registra i co-installer specifici del dispositivo elencati nel file INF per il dispositivo specificato. Questa funzione è il gestore predefinito per DIF_REGISTER_COINSTALLERS. |
|
Gestore predefinito per la richiesta di DIF_INSTALLDEVICE. |
|
Gestore predefinito per la richiesta di DIF_INSTALLDEVICEFILES. |
|
Gestore predefinito per la richiesta di DIF_INSTALLINTERFACES. Installa le interfacce elencate in DDInstall. Sezione Interfacce di un file INF del dispositivo. |
|
Questa funzione è obsoleta e non può essere usata in alcuna versione di Microsoft Windows. |
|
Gestore predefinito per la richiesta di DIF_REMOVEDEVICE. |
|
Gestore predefinito per la richiesta di DIF_UNREMOVE. |
|
Gestore predefinito per la richiesta di DIF_REGISTERDEVICE. |
|
Gestore predefinito per la richiesta di DIF_SELECTDEVICE. |
|
Gestore predefinito per la richiesta di DIF_SELECTBESTCOMPATDRV. |
|
Gestore predefinito per la richiesta di DIF_SELECTDEVICE. |
Funzioni di personalizzazione dell'installazione del dispositivo
Recupera i parametri di installazione della classe per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo. |
|
Imposta o cancella i parametri di installazione della classe per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo. |
|
Recupera i parametri di installazione del dispositivo per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo. |
|
Imposta i parametri di installazione del dispositivo per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo. |
|
Recupera i parametri di installazione per il driver specificato. |
|
Imposta i parametri di installazione per il driver specificato. |
Funzioni della classe Setup
Restituisce un elenco di GUID della classe di installazione che include ogni classe installata nel sistema. |
|
Restituisce un elenco di GUID della classe di installazione che include ogni classe installata nel sistema locale o in un sistema remoto. |
|
Recupera la descrizione della classe associata al GUID della classe di installazione specificata. |
|
Recupera la descrizione di una classe di installazione installata in un computer locale o remoto. |
|
Recupera la classe di un file INF del dispositivo specificato. |
|
Recupera i GUID associati al nome della classe specificato. Questo elenco è basato sulle classi attualmente installate nel sistema. |
|
Recupera i GUID associati al nome della classe specificato. Questo elenco risultante contiene le classi attualmente installate in un computer locale o remoto. |
|
Recupera il nome della classe associato al GUID della classe. |
|
Recupera il nome della classe associato a un GUID di classe. La classe può essere installata in un computer locale o remoto. |
|
Installa la sezione ClassInstall32 del file INF specificato. |
|
Installa un programma di installazione classi o una classe di interfaccia. |
|
Apre la chiave del Registro di sistema della classe di installazione del dispositivo o una sottochiave specifica della classe . |
|
Apre la chiave del Registro di sistema della classe di installazione del dispositivo, la chiave del Registro di sistema della classe dell'interfaccia del dispositivo o una sottochiave specifica della classe . Questa funzione apre la chiave specificata nel computer locale o in un computer remoto. |
Funzioni bitmap e icona
Compila un elenco di immagini che contiene bitmap per ogni classe installata e restituisce l'elenco in una struttura di dati. |
|
Compila un elenco di immagini di bitmap per ogni classe installata in un computer locale o remoto. |
|
Recupera l'indice all'interno dell'elenco di immagini della classe di una classe specificata. |
|
Recupera l'indice dell'icona mini fornita per la classe specificata. |
|
Disegna l'icona mini specificata nella posizione richiesta. |
|
Carica sia l'icona grande che quella mini per la classe specificata. |
|
Carica un'icona del dispositivo per un dispositivo specificato. (Windows Vista e versioni successive di Windows) |
|
Elimina definitivamente un elenco di immagini di classe. |
Funzioni dell'interfaccia del dispositivo
Nota
SetupApi non è supportato in tutte le edizioni di Windows. Quando possibile, è consigliabile usare API di livello inferiore, ad esempio quelle disponibili tramite CfgMgr32.dll. Per suggerimenti, vedere Conversione da SetupApi a CfgMgr32 .
Registra la funzionalità del dispositivo (un'interfaccia del dispositivo) per un dispositivo. |
|
Recupera informazioni su un'interfaccia del dispositivo esistente e la aggiunge al set di informazioni sul dispositivo specificato. |
|
Restituisce un alias dell'interfaccia del dispositivo specificata. |
|
Restituisce un set di informazioni sul dispositivo che contiene tutti i dispositivi di una classe specificata. |
|
Restituisce un set di informazioni sul dispositivo che contiene tutti i dispositivi di una classe specificata in un computer locale o remoto. |
|
Restituisce una struttura di contesto per un elemento dell'interfaccia dispositivo di un set di informazioni sul dispositivo. Ogni chiamata restituisce informazioni su un'interfaccia del dispositivo. La funzione può essere chiamata ripetutamente per ottenere informazioni su diverse interfacce esposte da uno o più dispositivi. |
|
Restituisce i dettagli su un'interfaccia del dispositivo specifica. |
|
Crea una sottochiave del Registro di sistema per archiviare informazioni su un'istanza dell'interfaccia del dispositivo e restituisce un handle alla chiave. |
|
Apre la sottochiave del Registro di sistema usata dalle applicazioni e dai driver per archiviare informazioni specifiche di un'istanza dell'interfaccia del dispositivo e restituisce un handle alla chiave. |
|
Elimina la sottochiave del Registro di sistema usata dalle applicazioni e dai driver per archiviare informazioni specifiche di un'istanza dell'interfaccia del dispositivo. |
|
Gestore predefinito per la richiesta di DIF_INSTALLINTERFACES. Installa le interfacce elencate in un DDInstall. Sezione Interfacce di un file INF del dispositivo. |
|
Rimuove un'interfaccia del dispositivo registrata dal sistema. |
|
Elimina un'interfaccia del dispositivo da un set di informazioni sul dispositivo. |
|
Imposta un'interfaccia del dispositivo specificata come interfaccia predefinita per una classe di dispositivo. |
|
Installa un programma di installazione della classe o una classe di interfaccia. |
|
Apre la chiave del Registro di sistema della classe di installazione del dispositivo , la chiave del Registro di sistema dell'interfaccia del dispositivo o una sottochiave specifica della classe. Questa funzione apre la chiave specificata nel computer locale o in un computer remoto. |
Funzioni delle proprietà del dispositivo (Windows Vista e versioni successive)
Nota
SetupApi non è supportato in tutte le edizioni di Windows. Quando possibile, è consigliabile usare API di livello inferiore, ad esempio quelle disponibili tramite CfgMgr32.dll. Per suggerimenti, vedere Conversione da SetupApi a CfgMgr32 .
Recupera una proprietà del dispositivo impostata per una classe di installazione del dispositivo o una classe dell'interfaccia del dispositivo. |
|
Recupera una proprietà di classe per una classe di installazione del dispositivo o una classe di interfaccia dispositivo in un computer locale o remoto. |
|
Recupera una matrice delle chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per una classe di installazione del dispositivo o una classe dell'interfaccia del dispositivo. |
|
Recupera una matrice delle chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per una classe di installazione del dispositivo o una classe di interfaccia dispositivo in un computer locale o remoto. |
|
Recupera una proprietà del dispositivo impostata per un'interfaccia del dispositivo. |
|
Recupera una matrice di chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'interfaccia del dispositivo. |
|
Recupera una proprietà dell'istanza del dispositivo. |
|
Recupera una matrice delle chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'istanza del dispositivo. |
|
Imposta una proprietà di classe per una classe di installazione del dispositivo o una classe di interfaccia del dispositivo. |
|
Imposta una proprietà del dispositivo per una classe di installazione del dispositivo o una classe di interfaccia del dispositivo in un computer locale o remoto. |
|
Imposta una proprietà del dispositivo di un'interfaccia del dispositivo. |
|
Imposta una proprietà dell'istanza del dispositivo. |
Funzioni del Registro di sistema
Nota
SetupApi non è supportato in tutte le edizioni di Windows. Quando possibile, è consigliabile usare API di livello inferiore, ad esempio quelle disponibili tramite CfgMgr32.dll. Per suggerimenti, vedere Conversione da SetupApi a CfgMgr32 .
Crea una chiave di archiviazione del Registro di sistema per informazioni di configurazione specifiche del dispositivo e restituisce un handle alla chiave. |
|
Apre una chiave di archiviazione del Registro di sistema per informazioni di configurazione specifiche del dispositivo e restituisce un handle alla chiave. |
|
Elimina le chiavi del Registro di sistema accessibili dall'utente specificate associate a un elemento informazioni sul dispositivo. |
|
Apre la chiave del Registro di sistema della classe di installazione o una sottochiave specifica della classe. |
|
Apre la chiave del Registro di sistema della classe di installazione del dispositivo, la chiave del Registro di sistema dell'interfaccia del dispositivo o una sottochiave specifica della classe. Questa funzione apre la chiave specificata nel computer locale o in un computer remoto. |
|
Crea una sottochiave del Registro di sistema nonvola per archiviare informazioni su un'istanza dell'interfaccia del dispositivo e restituisce un handle alla chiave. |
|
Apre la sottochiave del Registro di sistema usata dalle applicazioni e dai driver per archiviare informazioni specifiche di un'istanza dell'interfaccia del dispositivo e restituisce un handle alla chiave. |
|
Elimina la sottochiave del Registro di sistema usata dalle applicazioni e dai driver per archiviare informazioni specifiche di un'istanza dell'interfaccia del dispositivo. |
|
Imposta la proprietà del dispositivo Plug and Play specificata. |
|
Recupera la proprietà del dispositivo Plug and Play specificata. |
|
Recupera una proprietà della classe di dispositivo specificata dal Registro di sistema. |
|
Imposta una proprietà della classe di dispositivo specificata nel Registro di sistema. |
Altre funzioni
Recupera la sezione MODELLI INF decorati appropriati da usare durante l'installazione di un dispositivo da un file INF del dispositivo. |
|
Recupera la sezione DDInstall appropriata da usare durante l'installazione di un dispositivo da un file INF del dispositivo. |
|
Recupera il nome della sezione INF DDInstall che installa un dispositivo per un sistema operativo e un'architettura del processore specificata. |
|
Recupera il nome descrittivo associato a un ID profilo hardware. |
|
Recupera il nome descrittivo associato a un ID profilo hardware in un computer locale o remoto. |
|
Recupera un elenco di tutti gli ID profilo hardware attualmente definiti. |
|
Recupera un elenco di tutti gli ID profilo hardware attualmente definiti in un computer locale o remoto. |
|
Riavvia un dispositivo specificato o, se necessario, avvia tutti i dispositivi gestiti dalla stessa funzione e dai driver di filtro del dispositivo specificato. |