SP_PROPCHANGE_PARAMS 結構 (setupapi.h)

發行項
03/05/2024

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)

另請參閱

DIF_PROPERTYCHANGE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiChangeState

共用方式為