设备协安装程序

CoInstaller，也称协同安装程序，是微软公司开发的win32的DLL，它是用来帮助在Windows 2000以后的系统上进行设备安装。它被Setup API调用作为类安装程序的“助手”。例如，供应商可以提供协同安装程序将特定设备信息写入INF文件无法处理的注册表中。

协同安装程序可以是设备专用或类专用的。Setup API只在安装协同安装程序为其注册的设备时才调用一个设备专用的协同安装程序。操作系统(OS)及供应商可以为一个设备注册零个或多个设备专用的协同安装程序。在为协同安装程序注册安装设备设置类的任何设备时，Setup API调用类协同安装程序。操作系统及供应商可以为一个设备设置类注册一个或多个类协同安装程序。除此之外，类协同安装程序还可以为一个或多个设置类注册。

 

DLL文件的编写：

 

使用一个普通的WIN32类型的DLL即可，但在编写DLL的过程中有几个点需要注意一下：

 

1、编写的DLL要有一个DEF文件来定义DLL导出的函数，形式如下：

LIBRARYCoInstallerDll

 

EXPORTS

CoInstallEntryPoint

 

2、CoInstaller的DLL需要有一个导出函数来作为CoInstaller的入口函数的，那么这样一个入口函数的声明应采用如下的格式：

 

DWORD CALLBACK CoInstallEntryPoint(

       IN DI_FUNCTION InstallFunction,

       IN HDEVINFO DeviceInfoSet,

       IN PSP_DEVINFO_DATA DeviceInfoData,

       IN OUT PCOINSTALLER_CONTEXT_DATA Context);

 

3、在Dll的各个函数中不要加入类似：

MessageBox(NULL,L"!!!!!!", L"ggj", MB_OK);

之前一直出现的无法调用ConInstaller的错误，就是因为加入了这样一句提示框的消息。

 

 

4、这样编译生成的DLL在用作CoInstaller时有时可能会出现如下错误：

 

解决方法是更改DLL的工程属性，将运行库设定为Multi-threaded(/MT) or Multi-threaded DLL (/MD) 

 

在INF文件中进行CoInstallerr注册的过程中，当有两个以上的CoInstaller需要添加时，需要注意以下问题：

[GoodixTouchDriver.CoInstaller.AddReg]

HKR,,CoInstallers32,0x00010000,"WdfCoInstaller01011.dll, WdfCoInstaller", \

                        “GoodixTouchCoInstaller.dll, GoodixTouchCoInstaller”

 

This needs to be theGoodixTouchCoInstaller entry point name.

 

This way it willregister *both* coinstallers.

(note the slash at theend of the line indicating it continues on next line)

 

另外，在整个驱动的安装过程中，Device Specified CoInstaller是在整个安装的动作的最后阶段才被正式的处理的

 

Device SpecifiedCoInstaller对应的入口函数最好处理下面这个命令：

DIF_INSTALLDEVICE