DIF_PROPERTYCHANGE

Una richiesta di DIF_PROPERTYCHANGE notifica al programma di installazione che le proprietà del dispositivo cambiano. Il dispositivo è abilitato, disabilitato, avviato, arrestato o è stato modificato un elemento in una pagina delle proprietà. Questa richiesta DIF consente al programma di installazione di partecipare alla modifica.

Quando viene inviato

Quando un dispositivo è abilitato, disabilitato, riavviato, arrestato o le relative proprietà sono state modificate.

Ad esempio, Windows invia questa richiesta quando un provider di pagine delle proprietà imposta il flag DI_FLAGSEX_PROPCHANGE_PENDING nel campo FlagsEx della struttura SP_DEVINSTALL_PARAMS per il dispositivo.

Per altre informazioni sul rilevamento dell'avvio di un dispositivo per la prima volta o successivamente riavviato, vedere la sezione Operazione del programma di installazione.

Chi gestisce

Input del programma di installazione

DeviceInfoSet
Fornisce un handle al set di informazioni sul dispositivo che contiene il dispositivo.

DeviceInfoData
Fornisce un puntatore a una struttura SP_DEVINFO_DATA per 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
Una struttura SP_PROPCHANGE_PARAMS è associata a DeviceInfoData.

Output del programma di installazione

Nessuno

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 dovrebbe 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 del 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 del codice DIF predefinito

SetupDiChangeState

Operazione del programma di installazione

In risposta a una richiesta di DIF_PROPERTYCHANGE un programma di installazione può partecipare all'operazione di modifica della proprietà. I parametri di installazione della classe (SP_PROPCHANGE_PARAMS) indicano quale modifica viene apportata.

Una modifica della proprietà potrebbe richiedere un riavvio del sistema. Per informazioni su come riavviare il sistema, vedere SetupDiCallClassInstaller.

Quando Windows invia una richiesta di DIF_INSTALLDEVICE di installare un dispositivo per la prima volta, Windows avvia il dispositivo ma non invia una richiesta di DIF_PROPERTYCHANGE come parte dell'installazione. Se è necessario eseguire un'operazione di installazione personalizzata quando un dispositivo viene avviato per la prima volta e ogni volta che il dispositivo viene riavviato successivamente, un programma di installazione o un co-programma di installazione deve gestire la richiesta di DIF_INSTALLDEVICE che avvia il dispositivo per la prima volta e una richiesta di DIF_PROPERTYCHANGE che indica che l'azione di modifica dello stato è che il dispositivo viene avviato.

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

Requirements

Vedere anche

SetupDiChangeState

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_PROPCHANGE_PARAMS