DIF_NEWDEVICEWIZARD_POSTANALYZE

Articolo
06/15/2023

Una richiesta di DIF_NEWDEVICEWIZARD_POSTANALYZE consente a un programma di installazione di specificare le pagine della procedura guidata visualizzate dall'utente dopo la registrazione del nodo del dispositivo (devnode), ma prima che Windows installi i driver per il dispositivo. Questa richiesta viene usata solo durante l'installazione manuale di dispositivi non PnP.

Data di invio

Dopo che Windows registra il dispositivo, che rende il devnode "live", ma prima di Windows installa i driver per il dispositivo.

Chi gestisce

Co-installer di classe	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 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_NEWDEVICEWIZARD_DATA è associata a DeviceInfoData.

Output del programma di installazione

Parametri di installazione del dispositivo
Un programma di installazione può modificare i flag nei parametri di installazione del dispositivo. Windows non controlla i flag al completamento di questa richiesta DIF. Tuttavia, li verificherà più avanti nel processo di installazione.

Parametri di installazione della classe
Un programma di installazione può modificare il SP_NEWDEVICEWIZARD_DATA per fornire pagine personalizzate.

Valore restituito dal programma di installazione

Se un co-installer non gestisce questa richiesta DIF, restituisce NO_ERROR dal passaggio di pre-elaborazione. Se un co-installer gestisce questa richiesta, può restituire NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED o un codice di errore Win32.

Un programma di installazione della classe restituisce NO_ERROR se fornisce correttamente le pagine. In caso contrario, un programma di installazione della classe restituisce ERROR_DI_DO_DEFAULT o un codice di errore Win32.

Gestore di codice DIF predefinito

Nessuno

Operazione del programma di installazione

Una richiesta di DIF_NEWDEVICEWIZARD_POSTANALYZE consente a un programma di installazione di specificare le pagine della procedura guidata visualizzate da Windows dopo la registrazione del devnode, ma prima che Windows installi i driver per il dispositivo. Questa richiesta viene usata solo durante l'installazione manuale di dispositivi non PnP.

Se un programma di installazione aggiunge pagine postanalyze personalizzate, il programma di installazione deve prima verificare se NumDynamicPages nei parametri di installazione della classe ha raggiunto MAX_INSTALLWIZARD_DYNAPAGES.

Dopo che l'utente fa clic su Avanti in una pagina personalizzata, Windows installa i driver per il dispositivo e la gestione PnP avvia il dispositivo. Una pagina della procedura guidata postanalyze è l'ultima opportunità per un programma di installazione di eseguire operazioni prima del caricamento dei driver e dell'avvio del dispositivo.

Un programma di installazione deve specificare un titolo di intestazione guidata 97 e un sottotitolo di intestazione nella struttura PROPSHEETPAGE per una pagina guidata personalizzata. Un programma di installazione non deve sostituire il titolo della procedura guidata fornita dal sistema. Per altre informazioni sulle pagine delle proprietà, vedere la Microsoft Windows SDK per la documentazione della struttura PROPSHEETPAGE.

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