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
デバイスのプロパティが変更されました。
この状態の変更では、有効な値である限り 、スコープ 情報は無視され、デバイスが停止して再起動されます。
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
プロファイル固有の変更用のハードウェア プロファイル ID を指定します。 ゼロは、現在のハードウェア プロファイルを指定します。
要件
| 要件 | 値 |
|---|---|
| Header | setupapi.h (Setupapi.h を含む) |