struttura SP_PROPCHANGE_PARAMS (setupapi.h)
Una struttura SP_PROPCHANGE_PARAMS corrisponde a una richiesta di installazione DIF_PROPERTYCHANGE .
Sintassi
typedef struct _SP_PROPCHANGE_PARAMS {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
DWORD StateChange;
DWORD Scope;
DWORD HwProfile;
} SP_PROPCHANGE_PARAMS, *PSP_PROPCHANGE_PARAMS;
Members
ClassInstallHeader
Intestazione della richiesta di installazione contenente le dimensioni dell'intestazione e il codice DIF per la richiesta. Vedere SP_CLASSINSTALL_HEADER.
StateChange
Azione di modifica dello stato. I possibili valori sono i seguenti:
DICS_ENABLE
Il dispositivo è in corso di abilitazione.
Per questa modifica dello stato, Windows abilita il dispositivo se viene specificato il flag DICS_FLAG_GLOBAL .
Se viene specificato il flag DICS_FLAG_CONFIGSPECIFIC e viene specificato il profilo hardware corrente, Windows abilita il dispositivo. Se il DICS_FLAG_CONFIGSPECIFIC viene specificato e non il profilo hardware corrente, Windows imposta alcuni flag nel Registro di sistema e non modifica lo stato del dispositivo. Windows modificherà lo stato del dispositivo quando il profilo specificato diventa il profilo corrente.
DICS_DISABLE
Il dispositivo viene disabilitato.
Per questa modifica dello stato, Windows disabilita il dispositivo se viene specificato il flag di DICS_FLAG_GLOBAL .
Se viene specificato il flag DICS_FLAG_CONFIGSPECIFIC e viene specificato il profilo hardware corrente, Windows disabilita il dispositivo. Se il DICS_FLAG_CONFIGSPECIFIC viene specificato e non il profilo hardware corrente, Windows imposta alcuni flag nel Registro di sistema e non modifica lo stato del dispositivo.
DICS_PROPCHANGE
Le proprietà del dispositivo sono state modificate.
Per questa modifica dello stato, Windows ignora le informazioni sull'ambito purché sia un valore valido e arresta e riavvia il dispositivo.
DICS_START
Il dispositivo viene avviato (se la richiesta è per il profilo hardware attualmente attivo).
DICS_START deve essere DICS_FLAG_CONFIGSPECIFIC. Non è possibile eseguire tale modifica a livello globale.
Windows avvia il dispositivo solo se è specificato il profilo hardware corrente. In caso contrario, Windows imposta un flag del Registro di sistema e non modifica lo stato del dispositivo.
DICS_STOP
Il dispositivo viene arrestato. Lo stack di driver verrà scaricato e il flag di CSCONFIGFLAG_DO_NOT_START verrà impostato per il dispositivo.
DICS_STOP deve essere DICS_FLAG_CONFIGSPECIFIC. Non è possibile eseguire tale modifica a livello globale.
Windows arresta il dispositivo solo se è specificato il profilo hardware corrente. In caso contrario, Windows imposta un flag del Registro di sistema e non modifica lo stato del dispositivo.
I componenti non devono specificare DICS_STOP o DICS_START. È invece consigliabile usare DICS_PROPCHANGE per arrestare e riavviare un dispositivo per rendere effettive le modifiche apportate alla configurazione del dispositivo.
Scope
Flag che specificano l'ambito di una modifica della proprietà del dispositivo. Può essere uno dei valori seguenti:
DICS_FLAG_GLOBAL
Apportare la modifica in tutti i profili hardware.
DICS_FLAG_CONFIGSPECIFIC
Apportare la modifica solo nel profilo specificato.
Il flag seguente è obsoleto:
DICS_FLAG_CONFIGGENERAL
HwProfile
Fornisce l'ID del profilo hardware per le modifiche specifiche del profilo. Zero specifica il profilo hardware corrente.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | setupapi.h (include Setupapi.h) |