SP_PROPCHANGE_PARAMS-Struktur (setupapi.h)
Eine SP_PROPCHANGE_PARAMS-Struktur entspricht einer DIF_PROPERTYCHANGE Installationsanforderung.
Syntax
typedef struct _SP_PROPCHANGE_PARAMS {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
DWORD StateChange;
DWORD Scope;
DWORD HwProfile;
} SP_PROPCHANGE_PARAMS, *PSP_PROPCHANGE_PARAMS;
Member
ClassInstallHeader
Ein Installationsanforderungsheader, der die Headergröße und den DIF-Code für die Anforderung enthält. Siehe SP_CLASSINSTALL_HEADER.
StateChange
Zustandsänderungsaktion. Folgenden Werte sind möglich:
DICS_ENABLE
Das Gerät wird aktiviert.
Für diese Zustandsänderung aktiviert Windows das Gerät, wenn das flag DICS_FLAG_GLOBAL angegeben ist.
Wenn das flag DICS_FLAG_CONFIGSPECIFIC angegeben wird und das aktuelle Hardwareprofil angegeben wird, aktiviert Windows das Gerät. Wenn der DICS_FLAG_CONFIGSPECIFIC und nicht das aktuelle Hardwareprofil angegeben ist, legt Windows einige Flags in der Registrierung fest und ändert den Gerätestatus nicht. Windows ändert den Gerätestatus, wenn das angegebene Profil zum aktuellen Profil wird.
DICS_DISABLE
Das Gerät wird deaktiviert.
Für diese Zustandsänderung deaktiviert Windows das Gerät, wenn das flag DICS_FLAG_GLOBAL angegeben ist.
Wenn das flag DICS_FLAG_CONFIGSPECIFIC angegeben ist und das aktuelle Hardwareprofil angegeben ist, deaktiviert Windows das Gerät. Wenn der DICS_FLAG_CONFIGSPECIFIC und nicht das aktuelle Hardwareprofil angegeben ist, legt Windows einige Flags in der Registrierung fest und ändert den Gerätestatus nicht.
DICS_PROPCHANGE
Die Eigenschaften des Geräts wurden geändert.
Bei dieser Zustandsänderung ignoriert Windows die Bereichsinformationen , solange es sich um einen gültigen Wert handelt, und beendet und startet das Gerät neu.
DICS_START
Das Gerät wird gestartet (wenn die Anforderung für das derzeit aktive Hardwareprofil gilt).
DICS_START muss DICS_FLAG_CONFIGSPECIFIC sein. Sie können diese Änderung nicht global durchführen.
Windows startet das Gerät nur, wenn das aktuelle Hardwareprofil angegeben ist. Andernfalls legt Windows ein Registrierungsflag fest und ändert den Zustand des Geräts nicht.
DICS_STOP
Das Gerät wird angehalten. Der Treiberstapel wird entladen, und das CSCONFIGFLAG_DO_NOT_START-Flag wird für das Gerät festgelegt.
DICS_STOP muss DICS_FLAG_CONFIGSPECIFIC sein. Sie können diese Änderung nicht global durchführen.
Windows beendet das Gerät nur, wenn das aktuelle Hardwareprofil angegeben ist. Andernfalls legt Windows ein Registrierungsflag fest und ändert den Zustand des Geräts nicht.
Komponenten sollten keine DICS_STOP oder DICS_START angeben. Stattdessen sollten sie DICS_PROPCHANGE verwenden, um ein Gerät zu beenden und neu zu starten, damit Änderungen an der Gerätekonfiguration wirksam werden.
Scope
Flags, die den Bereich einer Geräteeigenschaftsänderung angeben. Dabei kann es sich um eine der folgenden Methoden handeln:
DICS_FLAG_GLOBAL
Nehmen Sie die Änderung in allen Hardwareprofilen vor.
DICS_FLAG_CONFIGSPECIFIC
Nehmen Sie die Änderung nur im angegebenen Profil vor.
Das folgende Flag ist veraltet:
DICS_FLAG_CONFIGGENERAL
HwProfile
Stellt die Hardwareprofil-ID für profilspezifische Änderungen bereit. Null gibt das aktuelle Hardwareprofil an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | setupapi.h (schließen Sie Setupapi.h ein) |