DIF_INSTALLDEVICEFILES
Una richiesta di DIF_INSTALLDEVICEFILES consente a un programma di installazione di partecipare alla copia dei file per supportare un dispositivo o di creare un elenco dei file per un dispositivo. I file del dispositivo includono file per il driver selezionato, tutte le interfacce del dispositivo e tutti i co-installer.
Data di invio
I componenti di installazione del dispositivo forniti dal sistema inviano questa richiesta DIF per diversi motivi. Alcuni componenti di installazione del dispositivo inviano questa richiesta DIF prima di DIF_REGISTER_COINSTALLERS, DIF_INSTALLINTERFACES e DIF_INSTALL_DEVICE per assicurarsi che tutti i file pertinenti possano essere copiati prima di procedere con l'installazione. Alcuni componenti di installazione del dispositivo omettono questa richiesta DIF e prevedono che i file vengano copiati durante la gestione di queste tre richieste DIF. Inoltre, alcuni componenti di installazione del dispositivo inviano questa richiesta DIF per recuperare l'elenco dei file associati a un dispositivo.
Chi gestisce
Co-programma di installazione classi |
Può gestire |
Programma di installazione condivisa del dispositivo |
Non gestisce |
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 i cui file di supporto devono essere copiati.
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.
Se il flag di DI_NOVCP è impostato, i parametri di installazione del dispositivo contengono un handle e programmi di installazione FileQueue validi che gestiscono questa richiesta DIF aggiungono le operazioni file alla coda e non eseguono il commit della coda.
Parametri di installazione della classe
Nessuno
Output del programma di installazione
Parametri di installazione del dispositivo
Un programma di installazione può modificare FileQueue, se presente.
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
Operazione del programma di installazione
In risposta a una richiesta di DIF_INSTALLDEVICEFILES un programma di installazione specifica le operazioni di file necessarie. Ad esempio, un programma di installazione può specificare un file aggiuntivo da copiare necessario per l'installazione del dispositivo. Se il flag DI_NOVCP è impostato, un programma di installazione specifica le operazioni sui file aggiungendole al fileQueue nei parametri di installazione del dispositivo. Vedere il Microsoft Windows SDK per informazioni su come usare le code di file e per le pagine di riferimento nelle funzioni di accodamento file, ad esempio SetupInstallFilesFromInfSection.
Se questa richiesta DIF viene inviata durante l'installazione del dispositivo e il programma di installazione restituisce un codice di errore di Microsoft Win32, Windows arresta l'installazione.
Se un componente di installazione del dispositivo fornito dal sistema invia questa richiesta DIF per recuperare un elenco dei file associati a un dispositivo, il componente recupera la coda di file ma non esegue il commit della coda.
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) |