structure SP_PROPCHANGE_PARAMS (setupapi.h)
Une structure SP_PROPCHANGE_PARAMS correspond à une demande d’installation DIF_PROPERTYCHANGE .
Syntaxe
typedef struct _SP_PROPCHANGE_PARAMS {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
DWORD StateChange;
DWORD Scope;
DWORD HwProfile;
} SP_PROPCHANGE_PARAMS, *PSP_PROPCHANGE_PARAMS;
Membres
ClassInstallHeader
En-tête de demande d’installation qui contient la taille d’en-tête et le code DIF de la demande. Voir SP_CLASSINSTALL_HEADER.
StateChange
Action de changement d’état. Peut avoir l’une des valeurs suivantes :
DICS_ENABLE
L’appareil est activé.
Pour ce changement d’état, Windows active l’appareil si l’indicateur DICS_FLAG_GLOBAL est spécifié.
Si l’indicateur DICS_FLAG_CONFIGSPECIFIC est spécifié et que le profil matériel actuel est spécifié, Windows active l’appareil. Si le DICS_FLAG_CONFIGSPECIFIC est spécifié et pas le profil matériel actuel, Windows définit certains indicateurs dans le Registre et ne modifie pas l’état de l’appareil. Windows modifie l’état de l’appareil lorsque le profil spécifié devient le profil actuel.
DICS_DISABLE
L’appareil est en cours de désactivation.
Pour ce changement d’état, Windows désactive l’appareil si l’indicateur DICS_FLAG_GLOBAL est spécifié.
Si l’indicateur DICS_FLAG_CONFIGSPECIFIC est spécifié et que le profil matériel actuel est spécifié, Windows désactive l’appareil. Si le DICS_FLAG_CONFIGSPECIFIC est spécifié et pas le profil matériel actuel, Windows définit certains indicateurs dans le Registre et ne modifie pas l’état de l’appareil.
DICS_PROPCHANGE
Les propriétés de l’appareil ont changé.
Pour ce changement d’état, Windows ignore les informations d’étendue tant qu’il s’agit d’une valeur valide, puis arrête et redémarre l’appareil.
DICS_START
L’appareil est en cours de démarrage (si la demande concerne le profil matériel actif).
DICS_START doit être DICS_FLAG_CONFIGSPECIFIC. Vous ne pouvez pas effectuer cette modification globalement.
Windows démarre l’appareil uniquement si le profil matériel actuel est spécifié. Sinon, Windows définit un indicateur de Registre et ne modifie pas l’état de l’appareil.
DICS_STOP
L’appareil est en cours d’arrêt. La pile des pilotes est déchargée et l’indicateur CSCONFIGFLAG_DO_NOT_START est défini pour l’appareil.
DICS_STOP doit être DICS_FLAG_CONFIGSPECIFIC. Vous ne pouvez pas effectuer cette modification globalement.
Windows arrête l’appareil uniquement si le profil matériel actuel est spécifié. Sinon, Windows définit un indicateur de Registre et ne modifie pas l’état de l’appareil.
Les composants ne doivent pas spécifier DICS_STOP ou DICS_START. Au lieu de cela, ils doivent utiliser DICS_PROPCHANGE pour arrêter et redémarrer un appareil afin que les modifications apportées à la configuration de l’appareil prennent effet.
Scope
Indicateurs qui spécifient l’étendue d’une modification de propriété d’appareil. Il peut s'agir d'une des méthodes suivantes :
DICS_FLAG_GLOBAL
Apportez la modification dans tous les profils matériels.
DICS_FLAG_CONFIGSPECIFIC
Apportez la modification dans le profil spécifié uniquement.
L’indicateur suivant est obsolète :
DICS_FLAG_CONFIGGENERAL
HwProfile
Fournit l’ID de profil matériel pour les modifications spécifiques au profil. Zéro spécifie le profil matériel actuel.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | setupapi.h (inclure Setupapi.h) |