|
當(dāng)用戶需要卸載USB Host設(shè)備驅(qū)動(dòng)時(shí)，將會(huì)調(diào)用USBUnInstallDriver函數(shù)
BOOL USBUnInstallDriver();
它與USBInstallDriver類似，不過(guò)是調(diào)用如下兩個(gè)函數(shù)
UnRegisterClientSettings
BOOL UnRegisterClientSettings(LPCWSTR szUniqueDriverId, LPCWSTR szReserved, LPCUSB_DRIVER_SETTINGS lpDriverSettings);
BOOL UnRegisterClientDriverID(LPCWSTR szUniqueDriverId);
其中szUniqueDriverId是注冊(cè)時(shí)，使用的ID，szReserved保留，故設(shè)置為NULL，lpDriverSettings則是驅(qū)動(dòng)程序設(shè)置信息。
例程如下：
BOOL USBUnInstallDriver()
{
RETAILMSG(1,(TEXT("USBUninstallDriver\r\n")));
BOOL fRet = FALSE;
USB_DRIVER_SETTINGS DriverSettings;
DriverSettings.dwCount = sizeof(DriverSettings);
DriverSettings.dwVendorId = 0x10C4;
DriverSettings.dwProductId = 0x0003;
DriverSettings.dwReleaseNumber = USB_NO_INFO;
DriverSettings.dwDeviceClass = USB_NO_INFO;
DriverSettings.dwDeviceSubClass = USB_NO_INFO;
DriverSettings.dwDeviceProtocol = USB_NO_INFO;
DriverSettings.dwInterfaceClass = 0;
DriverSettings.dwInterfaceSubClass = 0;
DriverSettings.dwInterfaceProtocol = 0;
fRet = UnRegisterClientSettings(L"USBTest", NULL, &DriverSettings);
if(fRet) {
fRet = UnRegisterClientDriverID(L"USBTest");
if(!fRet)
RETAILMSG(1,(TEXT("UnRegisterClientDriverID error\r\n")));
} else
RETAILMSG(1,(TEXT("UnRegisterClientSettings error\r\n")));
return fRet;
}
其中DriverSettings必須與USBInstallDriver的DriverSettings一致。
回到原來(lái)的流程，WinCE注冊(cè)表中已經(jīng)包含了驅(qū)動(dòng)信息，WinCE系統(tǒng)自動(dòng)查找注冊(cè)表，在找到設(shè)備對(duì)應(yīng)鍵值的DLL后，將會(huì)調(diào)用該DLL的USBDeviceAttach函數(shù)。
BOOL USBDeviceAttach(
USB_HANDLE hDevice,
LPCUSB_FUNCS lpUsbFuncs,
LPCUSB_INTERFACE lpInterface,
LPCWSTR szUniqueDriverId,
LPBOOL fAcceptControl,
DWORD dwUnused)
hDevice 設(shè)備句柄，操作USB設(shè)備時(shí)，需要使用該句柄
lpUsbFuncs 指向一個(gè)包含各種USB操作的函數(shù)指針
lpInterface USB接口信息，這里需要注意的是，如果在DriverSettings里dwInterfaceClass、dwInterfaceSubClass、dwInterfaceProtocol設(shè)置為USB_NO_INFO，則該指針為NULL
szUniqueDriverId 注冊(cè)設(shè)備ID
fAcceptControl 該值被賦值為TRUE，表示該驅(qū)動(dòng)能操作該設(shè)備。如果不能操作該設(shè)備，則“未能識(shí)別的USB設(shè)備”對(duì)話框會(huì)再次出現(xiàn)，要求用戶輸入驅(qū)動(dòng)程序名稱
dwUnused 未使用
在該函數(shù)內(nèi)，主要是做一些檢查，判斷是否能驅(qū)動(dòng)設(shè)備，還有就是注冊(cè)USB事件通知回調(diào)函數(shù)，以及激活流驅(qū)動(dòng)。對(duì)于檢查部分，這里不再詳細(xì)說(shuō)明。
首先，介紹一下激活流驅(qū)動(dòng)。
流驅(qū)動(dòng)為應(yīng)用程序提供了一個(gè)訪問(wèn)設(shè)備的接口，利用該接口可以像訪問(wèn)文件一樣訪問(wèn)設(shè)備。USB設(shè)備同樣可以使用該接口來(lái)為應(yīng)用程序提供支持。在注冊(cè)表的
HKEY_LOCAL_MACHINE\Drivers\BuiltIn鍵下，保存了各種WinCE內(nèi)建流驅(qū)動(dòng)程序的入口。這些驅(qū)動(dòng)通過(guò)device.exe在系統(tǒng)啟動(dòng)時(shí)被激活。像USB這樣的設(shè)備，只有插入時(shí)，才存在流
驅(qū)動(dòng)接口，所以我們需要手動(dòng)激活流驅(qū)動(dòng)。激活流驅(qū)動(dòng)的函數(shù)是：
HANDLE ActivateDevice(LPCWSTR lpszDevKey, DWORD dwClientInfo);
lpszDevKey 字符串指明了流驅(qū)動(dòng)所在注冊(cè)表的鍵。獲悉流驅(qū)動(dòng)的人都知道，流驅(qū)動(dòng)在注冊(cè)表中必須包含兩個(gè)鍵Prefix和Dll。
流驅(qū)動(dòng)中所有接口函數(shù)都有類似XXX_的前綴，而這個(gè)Prefix則指明XXX對(duì)應(yīng)的字符串，如Prefix為COM，則流驅(qū)動(dòng)包含如COM_Open、COM_Close、COM_Write、COM_Read這樣接口函數(shù)。Dll則說(shuō)明了這些函數(shù)所在的動(dòng)態(tài)鏈接庫(kù)。
在我的例子中存在如下的注冊(cè)表鍵：
[HKEY_LOCAL_MACHINE\Drivers\USB\ClientDrivers\USBTest]
"Prefix"="TST"
"Dll"="MyUSBTest.dll"
通過(guò)dwClientInfo，可以把參數(shù)間接傳給驅(qū)動(dòng)的XXX_init。我們可以把hDevice、lpUsbFuncs、lpInterface這樣信息放置在一個(gè)結(jié)構(gòu)體中，通過(guò)該函數(shù)傳遞給流驅(qū)動(dòng)使用。
USB通知回調(diào)函數(shù)，可以用來(lái)判斷各種USB事件的發(fā)生，如USB拔出。當(dāng)發(fā)生事件后，系統(tǒng)會(huì)根據(jù)注冊(cè)的回調(diào)函數(shù)做相應(yīng)的處理，在USB設(shè)備拔出后，所要做的事情，就是卸載流驅(qū)動(dòng)，并釋放占用的各種資源。
注冊(cè)回調(diào)函數(shù)是一個(gè)包含在lpUsbFuncs中的函數(shù)指針：
LPUN_REGISTER_NOTIFICATION_ROUTINE lpUnRegisterNotificationRoutine
該函數(shù)的聲明如下：
typedef BOOL (* LPREGISTER_NOTIFICATION_ROUTINE)(
USB_HANDLE hDevice,
LPDEVICE_NOTIFY_ROUTINE lpNotifyRoutine,
LPVOID lpvNotifyParameter
);
hDevice 設(shè)備句柄
lpNotifyRoutine 回調(diào)函數(shù)
lpvNotifyParameter 傳遞給回調(diào)函數(shù)的參數(shù)
在回調(diào)函數(shù)中卸載流驅(qū)動(dòng)使用
BOOL DeactivateDevice(HANDLE hDevice);
其中，hDevice 傳入ActivateDevice時(shí)返回的句柄。
下面是具體的示例：
typedef struct {
DWORD dwSize;
USB_HANDLE hDevice,
LPCUSB_FUNCS lpUsbFuncs,
LPCUSB_INTERFACE lpInterface,
HANDLE hStreamDevice;
} TESTUSBINFO, PTESTUSBINFO;
//回調(diào)函數(shù)
extern "C" BOOL USBDeviceNotifications(
LPVOID lpvNotifyParameter,
DWORD dwCode,
LPDWORD *dwInfo1,
LPDWORD *dwInfo2,
LPDWORD *dwInfo3,
LPDWORD *dwInfo4)
{
if (dwCode == USB_CLOSE_DEVICE) {
PTESTUSBINFO pDrv = (PDRVCONTEXT) lpvNotifyParameter;
DeactivateDevice(pDrv->hStreamDevice); //卸載流驅(qū)動(dòng)
LocalFree(pDrv); //釋放資源
}
RETAILMSG(1,(TEXT("Free Driver Resources!\r\n")));
return TRUE;
}
BOOL USBDeviceAttach(
USB_HANDLE hDevice,
LPCUSB_FUNCS lpUsbFuncs,
LPCUSB_INTERFACE lpInterface,
LPCWSTR szUniqueDriverId,
LPBOOL fAcceptControl,
DWORD dwUnused)
{
RETAILMSG(1,(TEXT("USBDeviceAttach\r\n")));
*fAcceptControl = FALSE;
//顯示USB設(shè)備的一些信息
if(lpInterface != NULL) {
RETAILMSG(1,(TEXT("usbserialhost: DeviceAttach, IF %u, #EP:%u, Class:%u, Sub:%u, Prot:%u\r\n"),
lpInterface->Descriptor.bInterfaceNumber,
lpInterface->Descriptor.bNumEndpoints,
lpInterface->Descriptor.bInterfaceClass,
lpInterface->Descriptor.bInterfaceSubClass,
lpInterface->Descriptor.bInterfaceProtocol));
RETAILMSG(1,(TEXT("Endpoint 1:%u\r\n"),
lpInterface->lpEndpoints[0].Descriptor.bmAttributes));
RETAILMSG(1,(TEXT("Endpoint 2:%u\r\n"),
lpInterface->lpEndpoints[1].Descriptor.bmAttributes));
RETAILMSG(1,(TEXT("Endpoint 3:%u\r\n"),
lpInterface->lpEndpoints[2].Descriptor.bmAttributes));
}
LPCUSB_DEVICE lpUsbDev = (lpUsbFuncs->lpGetDeviceInfo)(hDevice);
if(!lpUsbDev)
{
RETAILMSG(1,(TEXT("Unable to get USB device!\r\n")));
return FALSE;
}
//保存必要的信息供驅(qū)動(dòng)程序其他部分使用
PTESTUSBINFO pDrv = (PTESTUSBINFO)LocalAlloc (LPTR, sizeof (PTESTUSBINFO));
pDrv->dwSize = sizeof (DRVCONTEXT);
pDrv->hDevice = hDevice;
pDrv->lpUsbFuncs = lpUsbFuncs;
pDrv->lpInterface = lpInterface;
//激活流驅(qū)動(dòng)
pDrv->hStreamDevice = ActivateDevice (L"Drivers\\USB\\ClientDrivers\\USBTest", (DWORD)pDrv);
if (pDrv->hStreamDevice) {
//注冊(cè)回調(diào)函數(shù)
(*lpUsbFuncs->lpRegisterNotificationRoutine)(
hDevice,
USBDeviceNotifications,
pDrv);
} else {
RETAILMSG(1, (TEXT("Can't activate stream device! rc=%d\r\n"), GetLastError()));
LocalFree(pDrv);
return FALSE;
}
//驅(qū)動(dòng)可以操作該設(shè)備
*fAcceptControl = TRUE;
return TRUE;
}
至此，USB Host端設(shè)備驅(qū)動(dòng)程序所必須實(shí)現(xiàn)的功能都已經(jīng)實(shí)現(xiàn)。并且和流驅(qū)動(dòng)相連接。應(yīng)用程序已經(jīng)可以使用流驅(qū)動(dòng)的接口來(lái)操作USB設(shè)備了。
|
