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 を含む)

こちらもご覧ください

DIF_PROPERTYCHANGE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiChangeState