SP_CLASSINSTALL_HEADER 结构 (setupapi.h)

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 代码。

要求

要求
Header setupapi.h (包括 Setupapi.h)

另请参阅

SP_DETECTDEVICE_PARAMS

SP_MOVEDEV_PARAMS

SP_NEWDEVICEWIZARD_DATA

SP_POWERMESSAGEWAKE_PARAMS

SP_PROPCHANGE_PARAMS

SP_REMOVEDEVICE_PARAMS

SP_SELECTDEVICE_PARAMS

SP_TROUBLESHOOTER_PARAMS

SP_UNREMOVEDEVICE_PARAMS

SetupDiCallClassInstaller

SetupDiGetClassInstallParams

SetupDiSetClassInstallParams