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;

元件必須先設定 InstallFunction 成員，才能將類別安裝參數結構傳遞至 SetupDiSetClassInstallParams。

不過，將類別安裝參數傳遞至 SetupDiGetClassInstallParams 時，元件不需要設定此字段。此函式會在傳回給呼叫端的結構中設定 InstallFunction 成員。它會將 InstallFunction 設定為目前作用中裝置安裝要求的 DIF_XXX 程式代碼。