DIF_PROPERTYCHANGE

Articolo
06/15/2023

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

Data di invio

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

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

Per altre informazioni sul rilevamento quando un dispositivo viene avviato per la prima volta o successivamente riavviato, vedere la sezione Operazione del programma di installazione.

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 di SP_DEVINFO_DATA per il dispositivo nel set di informazioni del 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_PROPCHANGE_PARAMS è associata a DeviceInfoData.

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

SetupDiChangeState

Operazione del programma di installazione

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

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 per installare un dispositivo per la prima volta, Windows avvia il dispositivo ma non invia una richiesta di DIF_PROPERTYCHANGE come parte dell'installazione. Se un'operazione di installazione personalizzata deve essere eseguita quando un dispositivo viene avviato per la prima volta e ogni volta che il dispositivo viene riavviato, 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.