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)

Weitere Informationen

DIF_PROPERTYCHANGE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiChangeState