Uso delle funzioni di installazione dei dispositivi

Questa sezione riepiloga le funzioni di installazione dei dispositivi . 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 di driver.

• Gestire le interfacce dei dispositivi.

• Gestire le icone e le altre bitmap.

Le tabelle seguenti forniscono riepiloghi dei tipi di funzioni seguenti:

Funzioni di Installazione del Driver

Funzioni di informazione sul dispositivo

funzioni informazioni driver

gestori di installazione dei dispositivi

funzioni di personalizzazione dell'installazione dei dispositivi

Configurazione delle Funzioni della Classe

Funzioni Bitmap e Icone

funzioni dell'interfaccia del dispositivo

Funzioni delle proprietà del dispositivo (Windows Vista e versioni successive)

Funzioni del Registro di Sistema

Altre funzioni

Funzioni di installazione del driver

DiInstallDevice	Installa un pacchetto driver specificato preinstallato nell'archivio driver in un dispositivo PnP presente nel sistema. (Windows Vista e versioni successive di Windows)
DiUninstallDevice	Disinstalla un dispositivo e rimuove il nodo del dispositivo (devnode) dal sistema. (Windows 7 e versioni successive di Windows)
diInstallDriver	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)
diUninstallDriver	Rimuove un pacchetto driver dall'archivio driver. (Windows 10 versione 1703 e versioni successive di Windows)
UpdateDriverForPlugAndPlayDevices	Aggiorna il pacchetto driver installato per i dispositivi PnP corrispondenti presenti nel sistema.
DiRollbackDriver	Ripristina il pacchetto driver installato su un dispositivo specificato al pacchetto di driver di backup salvato per il dispositivo. (Windows Vista e versioni successive di Windows)

Funzioni di informazione 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.

SetupDiCreateDeviceInfoList	Crea un set vuoto di informazioni sul dispositivo . Questo set può essere associato a un GUID di classe.
SetupDiCreateDeviceInfoListEx	Crea un set di informazioni sul dispositivo vuoto. Questo set può essere associato a un GUID di classe e utilizzato per dispositivi su un computer remoto.
SetupDiCreateDeviceInfo	Crea un nuovo elemento di informazioni sul dispositivo e lo aggiunge come nuovo membro al set di informazioni sul dispositivo specificato.
SetupDiOpenDeviceInfo	Recupera informazioni su un'istanza del dispositivo esistente e la aggiunge al set di informazioni sul dispositivo specificato.
SetupDiEnumDeviceInfo	Restituisce una struttura di contesto per un elemento di informazioni sul dispositivo di un set di informazioni sul dispositivo.
SetupDiGetDeviceInstanceId	Recupera l'ID istanza del dispositivo associato a un elemento di informazioni sul dispositivo.
SetupDiGetDeviceInfoListClass	Recupera il GUID della classe associato a un set di informazioni sul dispositivo se ha una classe associata.
SetupDiGetDeviceInfoListDetail	Recupera le informazioni associate a un set di informazioni sul dispositivo, inclusi il GUID della classe, l'handle del computer remoto e il nome del computer remoto.
SetupDiGetClassDevPropertySheets	Recupera gli handle nelle finestre delle proprietà di un elemento di informazioni dispositivo specificato o della classe di configurazione del dispositivo di un set di informazioni del dispositivo specificato.
SetupDiGetClassDevs	Restituisce un set di informazioni sul dispositivo che contiene tutti i dispositivi di una classe specificata.
SetupDiGetClassDevsEx	Restituisce un set di informazioni sul dispositivo che contiene tutti i dispositivi di una classe specificata in un computer locale o remoto.
SetupDiSetSelectedDevice	Imposta l'elemento di informazioni sul dispositivo specificato come membro attualmente selezionato di un set di informazioni sul dispositivo. Questa funzione viene in genere utilizzata da un'installazione guidata.
SetupDiGetSelectedDevice	Recupera il dispositivo attualmente selezionato per il set di informazioni sul dispositivo specificato.
SetupDiRegisterDeviceInfo	Registra un'istanza del dispositivo appena creata con il gestore Plug and Play.
SetupDiDeleteDeviceInfo	Elimina un membro dal set di informazioni sul dispositivo specificato. Questa funzione non elimina il dispositivo effettivo.
SetupDiDestroyDeviceInfoList	Elimina un set di informazioni sul dispositivo e libera tutta la memoria associata.

Funzioni di informazione del driver

SetupDiBuildDriverInfoList	Compila un elenco di driver associati a un'istanza del dispositivo specificata o all'elenco di driver di classe globale del set di informazioni sul dispositivo.
SetupDiEnumDriverInfo	Enumera i membri di un elenco di informazioni sui driver.
SetupDiGetDriverInfoDetail	Recupera informazioni dettagliate per un elemento informativo del driver specificato.
SetupDiSetSelectedDriver	Imposta il membro specificato di un elenco di driver come driver attualmente selezionato. Può anche essere usato per reimpostare l'elenco di driver in modo che non sia presente alcun driver attualmente selezionato.
SetupDiGetSelectedDriver	Recupera il membro di un elenco di driver selezionato come driver da installare.
SetupDiCancelDriverInfoSearch	Annulla una ricerca nell'elenco di driver attualmente in corso in un thread diverso.
SetupDiDestroyDriverInfoList	Elimina un elenco di informazioni sui driver.

gestori di installazione dei dispositivi

SetupDiCallClassInstaller	Chiama il programma di installazione della classe appropriato ed eventuali co-installer registrati, con la richiesta di installazione specificata.
SetupDiChangeState	Gestore predefinito per la richiesta di DIF_PROPERTYCHANGE. Può essere usato per modificare lo stato di un dispositivo installato.
SetupDiRegisterCoDeviceInstallers	Registra i co-installer specifici del dispositivo elencati nel file INF per il dispositivo specificato. Questa funzione è il gestore predefinito per DIF_REGISTER_COINSTALLERS.
SetupDiInstallDevice	Gestore predefinito per la richiesta di DIF_INSTALLDEVICE.
SetupDiInstallDriverFiles	Gestore predefinito per la richiesta di DIF_INSTALLDEVICEFILES.
SetupDiInstallDeviceInterfaces	Gestore predefinito per la richiesta di DIF_INSTALLINTERFACES. Installa le interfacce elencate nella sezione DDInstall.interfacce di un file INF del dispositivo.
SetupDiMoveDuplicateDevice	Questa funzione è obsoleta e non può essere usata in alcuna versione di Microsoft Windows.
SetupDiRemoveDevice	Gestore predefinito per la richiesta di DIF_REMOVEDEVICE.
SetupDiUnremoveDevice	Gestore predefinito per la richiesta di DIF_UNREMOVE.
SetupDiRegisterDeviceInfo	Gestore predefinito per la richiesta di DIF_REGISTERDEVICE.
SetupDiSelectDevice	Gestore predefinito per la richiesta di DIF_SELECTDEVICE.
SetupDiSelectBestCompatDrv	Gestore predefinito per la richiesta di DIF_SELECTBESTCOMPATDRV.
SetupDiSelectDevice	Gestore predefinito per la richiesta di DIF_SELECTDEVICE.

Funzioni di personalizzazione dell'installazione dei dispositivi

SetupDiGetClassInstallParams	Recupera i parametri di installazione della classe per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.
SetupDiSetClassInstallParams	Imposta o cancella i parametri di installazione della classe per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.
SetupDiGetDeviceInstallParams	Recupera i parametri di installazione del dispositivo per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.
SetupDiSetDeviceInstallParams	Imposta i parametri di installazione del dispositivo per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.
SetupDiGetDriverInstallParams	Recupera i parametri di installazione per il driver specificato.
SetupDiSetDriverInstallParams	Imposta i parametri di installazione per il driver specificato.

Funzioni della classe Setup

SetupDiBuildClassInfoList	Restituisce un elenco di GUID della classe di installazione che include ogni classe installata nel sistema.
SetupDiBuildClassInfoListEx	Restituisce un elenco di GUID della classe di installazione che include ogni classe installata nel sistema locale o in un sistema remoto.
SetupDiGetClassDescription	Recupera la descrizione della classe associata al GUID della classe di configurazione specificata.
SetupDiGetClassDescriptionEx	Recupera la descrizione di una classe di installazione installata in un computer locale o remoto.
SetupDiGetINFClass	Recupera la classe di un file INF del dispositivo specificato.
SetupDiClassGuidsFromName	Recupera i GUID associati al nome della classe specificato. Questo elenco è basato sulle classi attualmente installate nel sistema.
SetupDiClassGuidsFromNameEx	Recupera i GUID associati al nome della classe specificato. Questo elenco risultante contiene le classi attualmente installate in un computer locale o remoto.
SetupDiClassNameFromGuid	Recupera il nome della classe associato al GUID della classe.
SetupDiClassNameFromGuidEx	Recupera il nome della classe associato a un GUID di classe. La classe può essere installata in un computer locale o remoto.
SetupDiInstallClass	Installa la sezione ClassInstall32 del file INF specificato.
SetupDiInstallClassEx	Installa un programma di installazione della classe o una classe di interfaccia.
SetupDiOpenClassRegKey	Apre la chiave di registro della classe di configurazione del dispositivo , o una specifica sottochiave della classe.
SetupDiOpenClassRegKeyEx	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 Bitmap e Icone

SetupDiGetClassImageList	Compila un elenco di immagini che contiene bitmap per ogni classe installata e restituisce l'elenco in una struttura di dati.
SetupDiGetClassImageListEx	Compila un elenco di immagini di bitmap per ogni classe installata in un computer locale o remoto.
SetupDiGetClassImageIndex	Recupera l'indice dalla lista di immagini per una classe specificata.
SetupDiGetClassBitmapIndex	Recupera l'indice dell'icona mini fornita per la classe specificata.
SetupDiDrawMiniIcon	Disegna la mini icona specificata nella posizione richiesta.
SetupDiLoadClassIcon	Carica sia l'icona grande che quella mini per la classe specificata.
SetupDiLoadDeviceIcon	Carica un'icona del dispositivo per un dispositivo specificato. (Windows Vista e versioni successive di Windows)
SetupDiDestroyClassImageList	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.

SetupDiCreateDeviceInterface	Registra la funzionalità del dispositivo (un'interfaccia del dispositivo) per un dispositivo.
SetupDiOpenDeviceInterface	Recupera informazioni su un'interfaccia del dispositivo esistente e la aggiunge al set di informazioni sul dispositivo specificato.
SetupDiGetDeviceInterfaceAlias	Restituisce un alias dell'interfaccia del dispositivo specificata.
SetupDiGetClassDevs	Restituisce un set di informazioni sul dispositivo che contiene tutti i dispositivi di una classe specificata.
SetupDiGetClassDevsEx	Restituisce un set di informazioni sul dispositivo che contiene tutti i dispositivi di una classe specificata in un computer locale o remoto.
SetupDiEnumDeviceInterfaces	Restituisce una struttura di contesto per un elemento dell'interfaccia del 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.
SetupDiGetDeviceInterfaceDetail	Restituisce informazioni dettagliate su una particolare interfaccia del dispositivo.
SetupDiCreateDeviceInterfaceRegKey	Crea una sottochiave del Registro di sistema per archiviare informazioni su un'istanza dell'interfaccia del dispositivo e restituisce un handle alla chiave.
SetupDiOpenDeviceInterfaceRegKey	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.
SetupDiDeleteDeviceInterfaceRegKey	Elimina la sottochiave del Registro di sistema usata dalle applicazioni e dai driver per archiviare informazioni specifiche di un'istanza dell'interfaccia del dispositivo.
SetupDiInstallDeviceInterfaces	Gestore predefinito per la richiesta DIF_INSTALLINTERFACES. Installa le interfacce elencate in un DDInstall.sezione interfacce di un file INF del dispositivo.
SetupDiRemoveDeviceInterface	Rimuove un'interfaccia dispositivo registrata dal sistema.
SetupDiDeleteDeviceInterfaceData	Elimina un'interfaccia del dispositivo da un set di informazioni sul dispositivo.
SetupDiSetDeviceInterfaceDefault	Imposta un'interfaccia dispositivo specificata come interfaccia predefinita per una classe di dispositivo.
SetupDiInstallClassEx	Installa un programma di installazione della classe o una classe di interfaccia.
SetupDiOpenClassRegKeyEx	Apre la classe di installazione del dispositivo chiave del Registro di sistema, 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 di 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. Vedere la migrazione da SetupApi a CfgMgr32 per suggerimenti.

SetupDiGetClassProperty	Recupera una proprietà del dispositivo impostata per una classe di installazione del dispositivo o una classe di interfaccia dispositivo.
SetupDiGetClassPropertyEx	Recupera una proprietà di classe per una classe di installazione del dispositivo o una classe di interfaccia dispositivo in un computer locale o remoto.
SetupDiGetClassPropertyKeys	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.
SetupDiGetClassPropertyKeysEx	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.
SetupDiGetDeviceInterfaceProperty	Recupera una proprietà del dispositivo impostata per un'interfaccia del dispositivo.
SetupDiGetDeviceInterfacePropertyKeys	Recupera una matrice di chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'interfaccia dispositivo.
SetupDiGetDeviceProperty	Recupera una proprietà dell'istanza del dispositivo.
SetupDiGetDevicePropertyKeys	Recupera una matrice delle chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'istanza del dispositivo.
SetupDiSetClassProperty	Imposta una proprietà di classe per una classe di installazione del dispositivo o una classe di interfaccia del dispositivo.
SetupDiSetClassPropertyEx	Imposta una proprietà del dispositivo per una classe di installazione del dispositivo o una classe di interfaccia dispositivo in un computer locale o remoto.
SetupDiSetDeviceInterfaceProperty	Imposta una proprietà relativa a un'interfaccia del dispositivo.
SetupDiSetDeviceProperty	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. Vedere la conversione da SetupApi a CfgMgr32 per suggerimenti.

SetupDiCreateDevRegKey	Crea una chiave di archiviazione del Registro di sistema per informazioni di configurazione specifiche del dispositivo e restituisce un handle alla chiave.
SetupDiOpenDevRegKey	Apre una chiave di archiviazione del Registro di sistema per informazioni di configurazione specifiche del dispositivo e restituisce un handle alla chiave.
SetupDiDeleteDevRegKey	Elimina le chiavi del Registro di sistema accessibili dall'utente specificate associate a un elemento di informazioni sul dispositivo.
SetupDiOpenClassRegKey	Apre la chiave del Registro di sistema della classe di installazione o una sottochiave specifica della classe .
SetupDiOpenClassRegKeyEx	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.
SetupDiCreateDeviceInterfaceRegKey	Crea una sottochiave del Registro di sistema non volatile per l'archiviazione di informazioni su un'istanza dell'interfaccia del dispositivo e restituisce un handle alla chiave.
SetupDiOpenDeviceInterfaceRegKey	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.
SetupDiDeleteDeviceInterfaceRegKey	Elimina la sottochiave del Registro di sistema usata dalle applicazioni e dai driver per archiviare informazioni specifiche di un'istanza dell'interfaccia del dispositivo.
SetupDiSetDeviceRegistryProperty	Imposta la proprietà del dispositivo Plug and Play specificata.
SetupDiGetDeviceRegistryProperty	Recupera la proprietà del dispositivo Plug and Play specificata.
SetupDiGetClassRegistryProperty	Recupera una proprietà della classe di dispositivo specificata dal Registro di sistema.
SetupDiSetClassRegistryProperty	Imposta una proprietà della classe di dispositivo specificata nel Registro di sistema.

Altre Funzioni

SetupDiGetActualModelsSection	Recupera la sezione decorata appropriata dei modelli INF da usare durante l'installazione da un file INF del dispositivo.
SetupDiGetActualSectionToInstall	Recupera la sezione DDInstall appropriata da usare durante l'installazione di un dispositivo da un file INF del dispositivo.
SetupDiGetActualSectionToInstallEx	Recupera il nome della sezione DDInstall INF che installa un dispositivo per un sistema operativo e un'architettura del processore specificati.
SetupDiGetHwProfileFriendlyName	Recupera il nome descrittivo associato a un ID profilo hardware.
SetupDiGetHwProfileFriendlyNameEx	Recupera il nome amichevole associato a un ID profilo hardware su un computer locale o remoto.
SetupDiGetHwProfileList	Recupera un elenco di tutti gli ID profilo hardware attualmente definiti.
SetupDiGetHwProfileListEx	Recupera un elenco di tutti gli ID profilo hardware attualmente definiti in un computer locale o remoto.
SetupDiRestartDevices	Riavvia un dispositivo specificato o, se necessario, avvia tutti i dispositivi gestiti dalla stessa funzione e filtrano i driver del dispositivo specificato.