DIF_UNREMOVE

Articolo
06/15/2023

Una richiesta di DIF_UNREMOVE notifica al programma di installazione che Windows sta per reintegrare un dispositivo in un determinato profilo hardware e offre al programma di installazione un'opportunità di partecipare all'operazione. Windows invia solo questa richiesta per i dispositivi non PnP.

Data di invio

Quando un dispositivo con enumerazione radice, il dispositivo non PnP viene ripristinato in un profilo hardware.

Chi gestisce

Co-installer di classe	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 del 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
Sono disponibili parametri di installazione del dispositivo (SP_DEVINSTALL_PARAMS) associati a DeviceInfoData.

Parametri di installazione della classe
Una struttura SP_UNREMOVEDEVICE_PARAMS è associata a DeviceInfoData. Il campo Ambito deve essere impostato su DI_UNREMOVEDEVICE_CONFIGSPECIFIC e un profilo hardware deve essere specificato nel campo HwProfile .

Output del programma di installazione

Nessuno

Valore restituito dal programma di installazione

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

Se un programma di installazione della 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 riscontra 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

SetupDiUnremoveDevice

Operazione del programma di installazione

"Unremoving" un dispositivo significa fondamentalmente che Windows cancella un flag che in precedenza contrassegnò un dispositivo come "non presente" in un determinato profilo hardware.

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