estructura de SP_PROPCHANGE_PARAMS (setupapi.h)

  • Artículo

Una estructura de SP_PROPCHANGE_PARAMS corresponde a una solicitud de instalación de DIF_PROPERTYCHANGE .

Sintaxis

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

Miembros

ClassInstallHeader

Encabezado de solicitud de instalación que contiene el tamaño del encabezado y el código DIF para la solicitud. Consulte SP_CLASSINSTALL_HEADER.

StateChange

Acción de cambio de estado. Puede ser uno de los siguientes valores:

DICS_ENABLE

El dispositivo se está habilitando.

Para este cambio de estado, Windows habilita el dispositivo si se especifica la marca DICS_FLAG_GLOBAL .

Si se especifica la marca DICS_FLAG_CONFIGSPECIFIC y se especifica el perfil de hardware actual, Windows habilita el dispositivo. Si se especifica el DICS_FLAG_CONFIGSPECIFIC y no el perfil de hardware actual, Windows establece algunas marcas en el Registro y no cambia el estado del dispositivo. Windows cambiará el estado del dispositivo cuando el perfil especificado se convierta en el perfil actual.

DICS_DISABLE

El dispositivo se está deshabilitando.

Para este cambio de estado, Windows deshabilita el dispositivo si se especifica la marca DICS_FLAG_GLOBAL .

Si se especifica la marca DICS_FLAG_CONFIGSPECIFIC y se especifica el perfil de hardware actual, Windows deshabilita el dispositivo. Si se especifica el DICS_FLAG_CONFIGSPECIFIC y no el perfil de hardware actual, Windows establece algunas marcas en el Registro y no cambia el estado del dispositivo.

DICS_PROPCHANGE

Las propiedades del dispositivo han cambiado.

Para este cambio de estado, Windows omite la información de ámbito siempre que sea un valor válido y detenga y reinicie el dispositivo.

DICS_START

El dispositivo se está iniciando (si la solicitud es para el perfil de hardware activo actualmente).

DICS_START debe ser DICS_FLAG_CONFIGSPECIFIC. No puede realizar ese cambio globalmente.

Windows solo inicia el dispositivo si se especifica el perfil de hardware actual. De lo contrario, Windows establece una marca del Registro y no cambia el estado del dispositivo.

DICS_STOP

El dispositivo se está deteniendo. La pila de controladores se descargará y la marca CSCONFIGFLAG_DO_NOT_START se establecerá para el dispositivo.

DICS_STOP debe ser DICS_FLAG_CONFIGSPECIFIC. No puede realizar ese cambio globalmente.

Windows solo detiene el dispositivo si se especifica el perfil de hardware actual. De lo contrario, Windows establece una marca del Registro y no cambia el estado del dispositivo.

Los componentes no deben especificar DICS_STOP ni DICS_START. En su lugar, deben usar DICS_PROPCHANGE para detener y reiniciar un dispositivo para que los cambios en la configuración del dispositivo surtan efecto.

Scope

Marcas que especifican el ámbito de un cambio de propiedad de dispositivo. Puede ser uno de los siguientes:

DICS_FLAG_GLOBAL

Realice el cambio en todos los perfiles de hardware.

DICS_FLAG_CONFIGSPECIFIC

Realice el cambio solo en el perfil especificado.

La marca siguiente está obsoleta:

DICS_FLAG_CONFIGGENERAL

HwProfile

Proporciona el identificador de perfil de hardware para los cambios específicos del perfil. Cero especifica el perfil de hardware actual.

Requisitos

Requisito Valor
Header setupapi.h (incluya Setupapi.h)

Consulte también

DIF_PROPERTYCHANGE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiChangeState