estrutura SP_PROPCHANGE_PARAMS (setupapi.h)
Uma estrutura SP_PROPCHANGE_PARAMS corresponde a uma solicitação de instalação DIF_PROPERTYCHANGE .
Sintaxe
typedef struct _SP_PROPCHANGE_PARAMS {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
DWORD StateChange;
DWORD Scope;
DWORD HwProfile;
} SP_PROPCHANGE_PARAMS, *PSP_PROPCHANGE_PARAMS;
Membros
ClassInstallHeader
Um cabeçalho de solicitação de instalação que contém o tamanho do cabeçalho e o código DIF da solicitação. Consulte SP_CLASSINSTALL_HEADER.
StateChange
Ação de alteração de estado. Pode ser um dos seguintes valores:
DICS_ENABLE
O dispositivo está sendo habilitado.
Para essa alteração de estado, o Windows habilitará o dispositivo se o sinalizador DICS_FLAG_GLOBAL for especificado.
Se o sinalizador DICS_FLAG_CONFIGSPECIFIC for especificado e o perfil de hardware atual for especificado, o Windows habilitará o dispositivo. Se o DICS_FLAG_CONFIGSPECIFIC for especificado e não o perfil de hardware atual, o Windows definirá alguns sinalizadores no Registro e não alterará o estado do dispositivo. O Windows alterará o estado do dispositivo quando o perfil especificado se tornar o perfil atual.
DICS_DISABLE
O dispositivo está sendo desabilitado.
Para essa alteração de estado, o Windows desabilita o dispositivo se o sinalizador DICS_FLAG_GLOBAL for especificado.
Se o sinalizador DICS_FLAG_CONFIGSPECIFIC for especificado e o perfil de hardware atual for especificado, o Windows desabilita o dispositivo. Se o DICS_FLAG_CONFIGSPECIFIC for especificado e não o perfil de hardware atual, o Windows definirá alguns sinalizadores no Registro e não alterará o estado do dispositivo.
DICS_PROPCHANGE
As propriedades do dispositivo foram alteradas.
Para essa alteração de estado, o Windows ignora as informações de Escopo , desde que seja um valor válido, e interrompe e reinicia o dispositivo.
DICS_START
O dispositivo está sendo iniciado (se a solicitação for para o perfil de hardware ativo no momento).
DICS_START deve ser DICS_FLAG_CONFIGSPECIFIC. Você não pode executar essa alteração globalmente.
O Windows só iniciará o dispositivo se o perfil de hardware atual for especificado. Caso contrário, o Windows define um sinalizador do Registro e não altera o estado do dispositivo.
DICS_STOP
O dispositivo está sendo interrompido. A pilha do driver será descarregada e o sinalizador CSCONFIGFLAG_DO_NOT_START será definido para o dispositivo.
DICS_STOP deve ser DICS_FLAG_CONFIGSPECIFIC. Você não pode executar essa alteração globalmente.
O Windows só interromperá o dispositivo se o perfil de hardware atual for especificado. Caso contrário, o Windows define um sinalizador do Registro e não altera o estado do dispositivo.
Os componentes não devem especificar DICS_STOP ou DICS_START. Em vez disso, eles devem usar DICS_PROPCHANGE para parar e reiniciar um dispositivo para fazer com que as alterações na configuração do dispositivo entrem em vigor.
Scope
Sinalizadores que especificam o escopo de uma alteração de propriedade do dispositivo. Um dos seguintes pode ser feito:
DICS_FLAG_GLOBAL
Faça a alteração em todos os perfis de hardware.
DICS_FLAG_CONFIGSPECIFIC
Faça a alteração somente no perfil especificado.
O seguinte sinalizador está obsoleto:
DICS_FLAG_CONFIGGENERAL
HwProfile
Fornece a ID do perfil de hardware para alterações específicas do perfil. Zero especifica o perfil de hardware atual.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | setupapi.h (inclua Setupapi.h) |