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)

Confira também

DIF_PROPERTYCHANGE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiChangeState