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_START 必須是 DICS_FLAG_CONFIGSPECIFIC。 您無法全域執行該變更。
只有在指定目前的硬體配置檔時，Windows 才會啟動裝置。 否則，Windows 會設定登錄旗標，且不會變更裝置的狀態。
DICS_STOP
裝置正在停止。 驅動程式堆疊將會卸除，且將會為裝置設定CSCONFIGFLAG_DO_NOT_START旗標。
DICS_STOP 必須是 DICS_FLAG_CONFIGSPECIFIC。 您無法全域執行該變更。
如果指定目前的硬體配置檔，Windows 只會停止裝置。 否則，Windows 會設定登錄旗標，且不會變更裝置的狀態。
元件不應該指定DICS_STOP或DICS_START。 相反地，他們應該使用DICS_PROPCHANGE來停止並重新啟動裝置，使裝置的組態變更生效。
Scope
指定裝置屬性變更範圍的旗標。 可以是下列其中一項：
DICS_FLAG_GLOBAL
在所有硬體配置檔中進行變更。
DICS_FLAG_CONFIGSPECIFIC
只在指定的配置檔中進行變更。
下列旗標已過時：
DICS_FLAG_CONFIGGENERAL
HwProfile
提供設定檔特定變更的硬體配置檔標識碼。 零會指定目前的硬體配置檔。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | setupapi.h (包括 Setupapi.h) |