Condividi tramite


Esecuzione di azioni Finish-Install

Nota

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

In Windows 8 e versioni successive di Windows, le azioni di installazione completa non vengono eseguite automaticamente come parte dell'installazione del dispositivo. Quando un dispositivo viene installato con un driver che include un'azione di completamento dell'installazione, l'azione di fine installazione non verrà eseguita automaticamente. Windows richiede invece a un utente di "Completare l'installazione del software del dispositivo" nell'area Notifiche o in Windows Action Center. L'installazione del software del dispositivo richiede autorizzazioni di amministratore. Se l'installazione non riesce, il software deve richiedere all'utente di ritentare l'installazione. L'installazione del software di supporto che deve accompagnare un driver può comunque essere eseguita con un'azione di installazione completa, ma non verrà installata automaticamente.

Prima di Windows 8, se un dispositivo viene contrassegnato come necessario per eseguire un'azione di installazione completa, Windows tenta inizialmente di completare le azioni di completamento dell'installazione eseguendo un processo di installazione completa in uno dei casi seguenti:

  • Per un dispositivo installato durante l'installazione di Windows, la prima volta che un amministratore accede a Windows al termine dell'installazione di Windows.

  • Per un dispositivo installato o reinstallato dopo l'installazione di Windows, al termine delle operazioni di installazione dei dispositivi di base, come indicato di seguito:

    • Per un'installazione hardware-first di un dispositivo, Windows esegue il processo iniziale di installazione finale. Se l'utente corrente non è un amministratore, Windows richiederà innanzitutto all'utente di immettere le credenziali di un amministratore prima di eseguire il processo di installazione iniziale.

    • Per un'installazione software-first di un dispositivo, Windows esegue il processo iniziale di fine installazione nel contesto dell'amministratore che ha avviato l'installazione o la reinstallazione.

Prima di Windows 8, se il tentativo iniziale di completare le azioni di installazione completa ha esito positivo, il processo di installazione completa cancella il dispositivo come contrassegnato per eseguire un'azione di installazione completa. Se il tentativo iniziale di completare le azioni di completamento dell'installazione ha esito negativo, il processo di installazione finale non cancella il dispositivo come contrassegnato per eseguire un'azione di installazione completa ed esce. Successivamente, mentre il dispositivo rimane contrassegnato per eseguire un'azione di installazione completa, Windows tenta ripetutamente di completare le azioni di installazione completa eseguendo un nuovo processo di installazione completa ogni volta che il dispositivo viene enumerato, come indicato di seguito:

  • Mentre il dispositivo rimane installato, al successivo accesso di un amministratore.

  • Se un amministratore fa clic su Analizza le modifiche hardware nel menu Azione di Gestione dispositivi o un programma di installazione chiama CM_Reenumerate_DevNode nel contesto di un amministratore.

Se il dispositivo viene contrassegnato per eseguire un'azione di completamento dell'installazione, il processo di installazione completa chiama SetupDiCallClassInstaller per inviare una richiesta di DIF_FINISHINSTALL_ACTION ai programmi di installazione per il dispositivo.

Se un programma di installazione ha azioni di installazione completate, il programma di installazione esegue azioni di installazione completa e restituisce un codice di errore appropriato per la richiesta di DIF_FINISHINSTALL_ACTION . Un programma di installazione restituisce uno dei codici di errore nella tabella seguente.

Codice di errore Significato

ERROR_DI_DO_DEFAULT

Programma di installazione classi: il programma di installazione della classe ha eseguito correttamente le azioni di completamento dell'installazione e richiede che Windows esegua l'elaborazione predefinita.

Il programma di installazione della classe restituisce anche questo codice di errore se non dispone di azioni di installazione completa o un'azione di installazione completa non riesce e non deve essere provato di nuovo.

Programma di installazione condivisa del dispositivo o della classe: i co-programmi di installazione non restituiscono questo codice di errore.

NO_ERROR

Programma di installazione classi: il programma di installazione della classe ha eseguito correttamente l'azione di completamento dell'installazione. Windows non deve eseguire l'elaborazione predefinita.

Programma di installazione condivisa del dispositivo o della classe: il co-programma di installazione ha eseguito correttamente le azioni di installazione completa o non ha azioni di installazione completa.

Il programma di installazione condivisa restituisce anche questo codice di errore se un'azione di completamento dell'installazione ha esito negativo e non deve essere provato di nuovo.

Errore di Microsoft Win32

Il programma di installazione della classe, il co-programma di installazione del dispositivo o il co-programma di installazione di classe ha rilevato un errore durante l'elaborazione di un'azione di completamento dell'installazione, ma dovrebbe tentare di elaborare nuovamente l'azione di fine installazione.

Restituendo un codice di errore Win32, il programma di installazione indica che Windows deve eseguire un altro processo di installazione completa per completare le azioni di installazione completa alla successiva enumerazione del dispositivo. Il programma di installazione deve anche informare l'utente di questa situazione.