SP_CLASSINSTALL_HEADER構造体 (setupapi.h)

[アーティクル]
03/01/2024

SP_CLASSINSTALL_HEADERは、クラスインストールパラメーター構造の最初のメンバーです。これには、インストールパラメーター構造の残りの形式を定義するデバイスインストール要求コードが含まれています。

構文

typedef struct _SP_CLASSINSTALL_HEADER {
  DWORD       cbSize;
  DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER, *PSP_CLASSINSTALL_HEADER;

メンバー

cbSize

SP_CLASSINSTALL_HEADER構造体のサイズ (バイト単位)。

InstallFunction

クラスインストールパラメーター構造体のデバイスインストール要求 (DIF コード)。

DIF コードの形式は DIF_XXX で、 Setupapi.h で定義されています。 DIF コードの詳細については、「デバイスインストール関数コード」を参照してください。

注釈

コンポーネントは、クラスインストールパラメーター構造体を割り当てると、通常、構造体のヘッダーフィールドを初期化します。このようなコンポーネントは、 InstallFunction メンバーをインストール要求の DIF コードに設定し、 cbSize をSP_CLASSINSTALL_HEADER構造体のサイズに設定します。例:

SP_REMOVEDEVICE_PARAMS RemoveDeviceParams;
RemoveDeviceParams.ClassInstallHeader.cbSize = sizeof(SP_CLASSINSTALL_HEADER);
RemoveDeviceParams.ClassInstallHeader.InstallFunction = DIF_REMOVE;

コンポーネントは、クラスのインストールパラメーター構造を SetupDiSetClassInstallParams に渡す前に、InstallFunction メンバーを設定する必要があります。

ただし、クラスインストールパラメーターを SetupDiGetClassInstallParams に渡すときに、コンポーネントでこのフィールドを設定する必要はありません。この関数は、呼び出し元に渡す構造体の InstallFunction メンバーを設定します。 InstallFunction は、現在アクティブなデバイスインストール要求のDIF_XXX コードに設定します。