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) |