SP_PROPCHANGE_PARAMS structure (setupapi.h)

An SP_PROPCHANGE_PARAMS structure corresponds to a DIF_PROPERTYCHANGE installation request.

Syntax

typedef struct _SP_PROPCHANGE_PARAMS {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  DWORD                  StateChange;
  DWORD                  Scope;
  DWORD                  HwProfile;
} SP_PROPCHANGE_PARAMS, *PSP_PROPCHANGE_PARAMS;

Members

ClassInstallHeader

An install request header that contains the header size and the DIF code for the request. See SP_CLASSINSTALL_HEADER.

StateChange

State change action. Can be one of the following values:

DICS_ENABLE

The device is being enabled.

For this state change, Windows enables the device if the DICS_FLAG_GLOBAL flag is specified.

If the DICS_FLAG_CONFIGSPECIFIC flag is specified and the current hardware profile is specified then Windows enables the device. If the DICS_FLAG_CONFIGSPECIFIC is specified and not the current hardware profile then Windows sets some flags in the registry and does not change the device's state. Windows will change the device state when the specified profile becomes the current profile.

DICS_DISABLE

The device is being disabled.

For this state change, Windows disables the device if the DICS_FLAG_GLOBAL flag is specified.

If the DICS_FLAG_CONFIGSPECIFIC flag is specified and the current hardware profile is specified then Windows disables the device. If the DICS_FLAG_CONFIGSPECIFIC is specified and not the current hardware profile then Windows sets some flags in the registry and does not change the device's state.

DICS_PROPCHANGE

The properties of the device have changed.

For this state change, Windows ignores the Scope information as long it is a valid value, and stops and restarts the device.

DICS_START

The device is being started (if the request is for the currently active hardware profile).

DICS_START must be DICS_FLAG_CONFIGSPECIFIC. You cannot perform that change globally.

Windows only starts the device if the current hardware profile is specified. Otherwise, Windows sets a registry flag and does not change the state of the device.

DICS_STOP

The device is being stopped. The driver stack will be unloaded and the CSCONFIGFLAG_DO_NOT_START flag will be set for the device.

DICS_STOP must be DICS_FLAG_CONFIGSPECIFIC. You cannot perform that change globally.

Windows only stops the device if the current hardware profile is specified. Otherwise, Windows sets a registry flag and does not change the state of the device.

Components should not specify DICS_STOP or DICS_START. Instead, they should use DICS_PROPCHANGE to stop and restart a device to cause changes in the device's configuration to take effect.

Scope

Flags that specify the scope of a device property change. Can be one of the following:

DICS_FLAG_GLOBAL

Make the change in all hardware profiles.

DICS_FLAG_CONFIGSPECIFIC

Make the change in the specified profile only.

The following flag is obsolete:

DICS_FLAG_CONFIGGENERAL

HwProfile

Supplies the hardware profile ID for profile-specific changes. Zero specifies the current hardware profile.

Requirements

See also

DIF_PROPERTYCHANGE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiChangeState