SP_PROPCHANGE_PARAMS 구조체(setupapi.h)
SP_PROPCHANGE_PARAMS 구조체는 DIF_PROPERTYCHANGE 설치 요청에 해당합니다.
구문
typedef struct _SP_PROPCHANGE_PARAMS {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
DWORD StateChange;
DWORD Scope;
DWORD HwProfile;
} SP_PROPCHANGE_PARAMS, *PSP_PROPCHANGE_PARAMS;
멤버
ClassInstallHeader
요청에 대한 헤더 크기 및 DIF 코드를 포함하는 설치 요청 헤더입니다. SP_CLASSINSTALL_HEADER 참조하세요.
StateChange
상태 변경 작업입니다. 다음 값 중 하나일 수 있습니다.
DICS_ENABLE
디바이스를 사용하도록 설정 중입니다.
이 상태 변경의 경우 DICS_FLAG_GLOBAL 플래그가 지정된 경우 Windows에서 디바이스를 사용하도록 설정합니다.
DICS_FLAG_CONFIGSPECIFIC 플래그가 지정되고 현재 하드웨어 프로필이 지정된 경우 Windows에서 디바이스를 사용하도록 설정합니다. DICS_FLAG_CONFIGSPECIFIC 지정되고 현재 하드웨어 프로필이 아닌 경우 Windows는 레지스트리에 일부 플래그를 설정하고 디바이스 상태를 변경하지 않습니다. 지정된 프로필이 현재 프로필이 되면 Windows에서 디바이스 상태가 변경됩니다.
DICS_DISABLE
디바이스를 사용하지 않도록 설정 중입니다.
이 상태 변경의 경우 DICS_FLAG_GLOBAL 플래그가 지정된 경우 Windows에서 디바이스를 사용하지 않도록 설정합니다.
DICS_FLAG_CONFIGSPECIFIC 플래그를 지정하고 현재 하드웨어 프로필을 지정하면 Windows에서 디바이스를 사용하지 않도록 설정합니다. DICS_FLAG_CONFIGSPECIFIC 지정되고 현재 하드웨어 프로필이 아닌 경우 Windows는 레지스트리에 일부 플래그를 설정하고 디바이스 상태를 변경하지 않습니다.
DICS_PROPCHANGE
디바이스의 속성이 변경되었습니다.
이 상태 변경의 경우 Windows는 유효한 값인 범위 정보를 무시하고 디바이스를 중지하고 다시 시작합니다.
DICS_START
디바이스가 시작되고 있습니다(요청이 현재 활성 하드웨어 프로필인 경우).
DICS_STARTDICS_FLAG_CONFIGSPECIFIC 합니다. 이러한 변경은 전역적으로 수행할 수 없습니다.
Windows는 현재 하드웨어 프로필이 지정된 경우에만 디바이스를 시작합니다. 그렇지 않으면 Windows에서 레지스트리 플래그를 설정하고 디바이스의 상태를 변경하지 않습니다.
DICS_STOP
디바이스가 중지되고 있습니다. 드라이버 스택이 언로드되고 디바이스에 대해 CSCONFIGFLAG_DO_NOT_START 플래그가 설정됩니다.
DICS_STOPDICS_FLAG_CONFIGSPECIFIC 합니다. 이러한 변경은 전역적으로 수행할 수 없습니다.
Windows는 현재 하드웨어 프로필이 지정된 경우에만 디바이스를 중지합니다. 그렇지 않으면 Windows에서 레지스트리 플래그를 설정하고 디바이스의 상태를 변경하지 않습니다.
구성 요소는 DICS_STOP 또는 DICS_START 지정해서는 안 됩니다. 대신 DICS_PROPCHANGE 사용하여 디바이스를 중지하고 다시 시작하여 디바이스 구성 변경 내용이 적용되도록 해야 합니다.
Scope
디바이스 속성 변경의 scope 지정하는 플래그입니다. 다음 중 하나일 수 있습니다.
DICS_FLAG_GLOBAL
모든 하드웨어 프로필을 변경합니다.
DICS_FLAG_CONFIGSPECIFIC
지정된 프로필에서만 변경합니다.
다음 플래그는 사용되지 않습니다.
DICS_FLAG_CONFIGGENERAL
HwProfile
프로필별 변경에 대한 하드웨어 프로필 ID를 제공합니다. 0은 현재 하드웨어 프로필을 지정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | setupapi.h(Setupapi.h 포함) |