Chiamata dei gestori di codice DIF predefiniti

Nota

Le funzionalità descritte in questa sezione non sono supportate nei pacchetti di driver universali o mobili. Vedere Uso di un file INF universale.

I gestori di codice DIF predefiniti eseguono operazioni predefinite definite dal sistema per i codici DIF. Come descritto in Gestione codici DIF, SetupDiCallClassInstaller chiama il gestore predefinito per una richiesta DIF dopo che il programma di installazione della classe e il co-installer hanno prima elaborato la richiesta DIF, ma prima di SetupDiCallClassInstaller richiama i co-installer registrati per la post-elaborazione della richiesta.

Nota Impossibile configurare l'operazione di SetupDiCallClassInstaller per richiamare il programma di installazione della classe per eseguire il post-elaborazione di una richiesta DIF.

In queste situazioni in cui un programma di installazione della classe deve eseguire operazioni per una richiesta DIF dopo che viene chiamato il gestore predefinito, il programma di installazione della classe deve chiamare direttamente il gestore predefinito quando elabora la richiesta DIF, come indicato di seguito:

  1. Eseguire operazioni che devono essere eseguite prima di chiamare il gestore predefinito.

  2. Chiamare il gestore predefinito per eseguire le operazioni predefinite.

    Nota Il programma di installazione della classe non deve tentare di sostituire l'operazione del gestore predefinito.

  3. Eseguire le operazioni che devono essere eseguite dopo che il gestore predefinito restituisce.

  4. Restituisce NO_ERROR se il programma di installazione della classe ha completato correttamente l'elaborazione della richiesta DIF o restituisce un errore Win32 se l'elaborazione non è riuscita.

Importanti programmi di installazione eapplicazioni di installazione dei dispositivi non devono chiamare i gestori di codice DIF predefiniti.

Per un esempio di situazione in cui è necessario usare questo metodo, vedere le informazioni sulla chiamata al gestore predefinito SetupDiInstallDevice nella pagina di riferimento della richiesta di DIF_INSTALLDEVICE .

Nella tabella seguente sono elencati i codici DIF con gestori predefiniti.

Codice DIF Funzione del gestore del codice DIF predefinita
DIF_PROPERTYCHANGE SetupDiChangeState
DIF_FINISHINSTALL_ACTION SetupDiFinishInstallAction
DIF_INSTALLDEVICE SetupDiInstallDevice
DIF_INSTALLINTERFACES SetupDiInstallDeviceInterfaces
DIF_INSTALLDEVICEFILES SetupDiInstallDriverFiles
DIF_REGISTER_COINSTALLERS SetupDiRegisterCoDeviceInstallers
DIF_REGISTERDEVICE SetupDiRegisterDeviceInfo
DIF_REMOVE SetupDiRemoveDevice
DIF_SELECTBESTCOMPATDRV SetupDiSelectBestCompatDrv
DIF_SELECTDEVICE SetupDiSelectDevice
DIF_UNREMOVE SetupDiUnremoveDevice