DIF_INSTALLINTERFACES

Articolo
06/15/2023

Una richiesta di DIF_INSTALLINTERFACES consente a un programma di installazione di partecipare alla registrazione delle interfacce del dispositivo per un dispositivo.

Data di invio

Dopo aver registrato i coinstallazioni dei dispositivi, ma prima di completare l'installazione del dispositivo.

Chi gestisce

Co-programma di installazione classi	Può gestire
Programma di installazione condivisa del dispositivo	Può gestire
Programma di installazione classi	Può gestire

Input del programma di installazione

DeviceInfoSet
Fornisce un handle al set di informazioni sul dispositivo che contiene il dispositivo.

DeviceInfoData
Fornisce un puntatore a una struttura SP_DEVINFO_DATA che identifica il dispositivo nel set di informazioni sul dispositivo.

Parametri di installazione del dispositivo
Esistono parametri di installazione del dispositivo (SP_DEVINSTALL_PARAMS) associati a DeviceInfoData.

Parametri di installazione della classe
Nessuno

Output del programma di installazione

Parametri di installazione del dispositivo
Un programma di installazione potrebbe modificare i parametri di installazione del dispositivo, ma in genere non per questa richiesta DIF.

Valore restituito del programma di installazione

Un co-programma di installazione può restituire NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED o un codice di errore Win32.

Se un programma di installazione di classe gestisce correttamente questa richiesta e SetupDiCallClassInstaller deve successivamente chiamare il gestore predefinito, il programma di installazione della classe restituisce ERROR_DI_DO_DEFAULT.

Se il programma di installazione della classe gestisce correttamente questa richiesta, inclusa la chiamata diretta al gestore predefinito, il programma di installazione della classe deve restituire NO_ERROR e SetupDiCallClassInstaller non chiamerà di nuovo il gestore predefinito.

Nota Il programma di installazione della classe può chiamare direttamente il gestore predefinito, ma il programma di installazione della classe non deve mai tentare di sostituire le operazioni del gestore predefinito.

Per altre informazioni sulla chiamata al gestore predefinito, vedere Chiamata di gestori di codice DIF predefiniti.

Se il programma di installazione della classe rileva un errore, il programma di installazione deve restituire un codice di errore Win32 appropriato e SetupDiCallClassInstaller non chiamerà successivamente il gestore predefinito.

Gestore di codice DIF predefinito

SetupDiInstallDeviceInterfaces

Operazione del programma di installazione

In risposta a una richiesta di DIF_INSTALLINTERFACES un programma di installazione potrebbe registrare un'interfaccia del dispositivo a livello di codice anziché registrare l'interfaccia tramite il file INF. In genere, i programmi di installazione forniti dal fornitore non gestiscono questa richiesta DIF.

A meno che non sia impostato il flag di DI_NOFILECOPY, un programma di installazione che gestisce questa richiesta DIF deve copiare i file necessari per le interfacce del dispositivo.

Se il flag DI_NOFILECOPY è chiaro, ma il flag DI_NOVCP è impostato, il programma di installazione deve accodare tutte le operazioni di file alla coda di file fornita ma non deve eseguire il commit della coda.

Se un programma di installazione registra un'interfaccia del dispositivo, un componente in modalità kernel per il dispositivo (ad esempio, un driver) deve chiamare IoSetDeviceInterfaceState per abilitare l'interfaccia.

Se il programma di installazione restituisce un codice di errore Win32, Windows arresta l'installazione.

Per altre informazioni sui codici DIF, vedere Gestione dei codici DIF.

Requisiti

Versione	Supportato in Microsoft Windows 2000 e versioni successive di Windows.
Intestazione	Setupapi.h (include Setupapi.h)

Vedi anche