DIF_REGISTER_COINSTALLERS
Una richiesta di DIF_REGISTER_COINSTALLERS consente a un programma di installazione di partecipare alla registrazione dei co-installer del dispositivo.
Data di invio
Prima di completare l'installazione del 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 per cui devono essere registrati i co-programmi di installazione.
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
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
SetupDiRegisterCoDeviceInstallers
Operazione del programma di installazione
In risposta a una richiesta di DIF_REGISTER_COINSTALLERS un programma di installazione potrebbe modificare l'elenco dei co-installer per il dispositivo. Ad esempio, un programma di installazione potrebbe registrare o rimuovere a livello di codice un co installer specifico del dispositivo per il dispositivo basato sull'analisi del dispositivo.
A meno che il flag di DI_NOFILECOPY non sia impostato, un programma di installazione che gestisce questa richiesta DIF deve copiare i file necessari per i co-installer.
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 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) |