estructura de SP_PROPCHANGE_PARAMS (setupapi.h)
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) |