Sunday, February 25, 2007

如何安装一个设备驱动程序

本质上,安装驱动需要依靠UpdateDriverForPlugAndPlayDevices这个函数。它需要的参数其实不多,主要是INF文件路径等。

BOOL WINAPI
UpdateDriverForPlugAndPlayDevices(
HWND hwndParent,
LPCTSTR HardwareId,
LPCTSTR FullInfPath,
DWORD InstallFlags,
PBOOL bRebootRequired OPTIONAL
);
执行这个函数相当于在设备管理器右键菜单上点击“扫描检测硬件改动”。它会查找当前已经添加到系统中但可能还没有安装驱动程序的硬件设备。由于没有对应的硬件,因此我们要另想办法,让它能检测到虚拟硬件的存在。

为此,我们需要创建一设备信息块,并将它弄到系统注册表中去。

创建设备信息块的函数是SetupDiCreateDeviceInfo

WINSETUPAPI BOOL WINAPI
SetupDiCreateDeviceInfo(
IN HDEVINFO DeviceInfoSet,
IN PCTSTR DeviceName,
IN LPGUID ClassGuid,
IN PCTSTR DeviceDescription, OPTIONAL
IN HWND hwndParent, OPTIONAL
IN DWORD CreationFlags,
OUT PSP_DEVINFO_DATA DeviceInfoData OPTIONAL
);

这个函数需要7个参数,其他的都好办,无非是设备ID字符串,设备GUID等,还有一个用于输出的结构体,记住填写其中的size字段,其余为0就可以了。问题是第一个参数HDEVINFO需要用另一个函数SetupDiCreateDeviceInfoList来创建。如果GUID不想写死,想通过INF读取,则需要另一个函数SetupDiGetINFClass。

HDEVINFO
SetupDiCreateDeviceInfoList(
IN LPGUID ClassGuid, OPTIONAL
IN HWND hwndParent OPTIONAL
);

WINSETUPAPI BOOL WINAPI
SetupDiGetINFClass(
IN PCTSTR InfName,
OUT LPGUID ClassGuid,
OUT PTSTR ClassName,
IN DWORD ClassNameSize,
OUT PDWORD RequiredSize OPTIONAL,
);

以上函数调用的顺序是:SetupDiGetINFClass获取GUID,SetupDiCreateDeviceInfoList创建设备信息块列表,SetupDiCreateDeviceInfo创建设备信息块。完成这些步骤之后,我们就可以注册设备了。首先,我们要调用SetupDiSetDeviceRegistryProperty这个函数来设置设备在系统设备树上的路径,然后通过SetupDiCallClassInstaller这个函数来注册:


WINSETUPAPI BOOL WINAPI
SetupDiSetDeviceRegistryProperty(
IN HDEVINFO DeviceInfoSet,
IN OUT PSP_DEVINFO_DATA DeviceInfoData,
IN DWORD Property,
IN CONST BYTE *PropertyBuffer,
IN DWORD PropertyBufferSize
);

这个函数的作用是设置驱动信息块中的信息。对于我们最重要的是其中的硬件ID。这通过给第三个参数以SPDRP_HARDWAREID这个值就可以实现。这时候,第四个参数就是指向硬件ID字符串的指针,第五个参数就是字符串的字节长度。

WINSETUPAPI BOOL WINAPI
SetupDiCallClassInstaller(
IN DI_FUNCTION InstallFunction,
IN HDEVINFO DeviceInfoSet,
IN PSP_DEVINFO_DATA DeviceInfoData OPTIONAL
);

这个函数第一个参数要用DIF_REGISTERDEVICE填充以便注册设备,第二项填写设备信息块列表,第三项则填写设备信息块。


明天继续介绍如何卸载设备。

Virtual Bus设计路线图

STEP1: 完成基本框架,能正常安装设备,并可在设备管理器看到。应用可以向驱动发送消息。

STEP2: 驱动向系统枚举一个USB Root Hub设备,设备管理器应该看到该设备。

STEP3: 应用向系统发送一个消息,驱动应该马上向USB Root Hub发送URB使它认为一个USB键盘已经插入系统中。

STEP4: 使该USB键盘可以工作。

STEP5: 全面完成应用与驱动的接口,使所有的URB都可以从核心态路由到应用态。

STEP6: 完成一些基本应用,包括:键盘、鼠标、U盘,声卡,网卡,摄像头等,主要以Windows自带驱动的为主。