【正文】 ESS。 //判斷此次功能代碼 switch( MinorFunction) { case IRP_MN_START_DEVICE://如果為插入設(shè)備，則處理相應(yīng)的子函數(shù) status = PnpStartDeviceHandler(fdo,Irp)。 break。 case IRP_MN_QUERY_REMOVE_DEVICE://如果為查詢拔出設(shè)備，則處理拔出設(shè)//備子函數(shù) status = PnpQueryRemoveDeviceHandler(fdo,Irp)。 break。 case IRP_MN_SURPRISE_REMOVAL://為意外拔出設(shè)備 status = PnpSurpriseRemovalHandler(fdo,Irp)。 break。 case IRP_MN_REMOVE_DEVICE://為正常拔出設(shè)備 status = PnpRemoveDeviceHandler(fdo,Irp)。 return status。 case IRP_MN_QUERY_STOP_DEVICE://為查詢停止使用設(shè)備，則設(shè)置相應(yīng)位 dxPaused = true。 dxIODisabled = true。 status = PnpDefaultHandler(fdo,Irp)。 break。 case IRP_MN_STOP_DEVICE://為停止設(shè)備 status = PnpStopDeviceHandler(fdo,Irp)。 break。 case IRP_MN_CANCEL_REMOVE_DEVICE: // 為取消拔出設(shè)備 case IRP_MN_CANCEL_STOP_DEVICE: //為取消停止設(shè)備，則設(shè)置相應(yīng)位 dxPaused = false。 dxIODisabled = false。 default://在缺省情況下，處理通用的子函數(shù) status = PnpDefaultHandler(fdo,Irp)。 } UnlockDevice(dx)。//解鎖設(shè)備并返回 return status。}中斷傳輸U(kuò)sb管道句柄可用？輸入緩沖區(qū)合適？循環(huán)得到鍵盤數(shù)據(jù)定時(shí)器中斷檢查超時(shí)釋放內(nèi)存并返回 圖3－7 中斷傳輸?shù)某绦蛄鞒?UsbKbd的實(shí)現(xiàn)目的，就是根據(jù)原始鍵盤數(shù)據(jù)來應(yīng)答Win32請(qǐng)求ReadFile（），并實(shí)現(xiàn)10秒的延時(shí)。 在描述如何處理讀“IRP”之前，必須討論USB HID鍵盤如何產(chǎn)生數(shù)據(jù)。鍵盤以一個(gè)8位數(shù)據(jù)報(bào)告相應(yīng)USB中斷傳輸。這個(gè)塊的格式定義在HID（人工接口設(shè)備）類中有定義。當(dāng)按下和松開一個(gè)鍵時(shí)，就產(chǎn)生一個(gè)鍵盤數(shù)據(jù)報(bào)告。即使沒有發(fā)生擊鍵的動(dòng)作，也定期產(chǎn)生一個(gè)報(bào)告。這就是在USB總線上發(fā)生的動(dòng)作。USB類驅(qū)動(dòng)程序定期開始一個(gè)中斷傳輸。一般USB鍵盤都規(guī)定了一個(gè)每多少秒發(fā)生一次中斷傳輸，用于實(shí)驗(yàn)的鍵盤時(shí)每8ms發(fā)生一次。但是，USB鍵盤有空閑的時(shí)候，如果在空閑時(shí)間段內(nèi)沒有發(fā)生狀態(tài)改變，鍵盤以NAK相應(yīng)每個(gè)中斷請(qǐng)求。在空閑時(shí)間段（500ms左右）的最后，鍵盤返回?cái)?shù)據(jù)。可以在缺省管道上使用類特定的的函數(shù)讀取和改變空閑率（UsbGetIdleRate()）。 UsbKbd發(fā)出“中斷傳輸”URB接收任何鍵盤報(bào)告。如果沒有鍵盤鍵被按下，8字節(jié)的鍵盤報(bào)告全為0，UsbKbd的“讀”Irp處理程序忽略全為0的任何鍵盤報(bào)告。當(dāng)一個(gè)鍵被按下和松開，一個(gè)真正的驅(qū)動(dòng)程序會(huì)返回讀取的數(shù)據(jù)。 UsbDoInterruptTransfer（…）的程序流程如圖3－6，下面是主要的偽代碼：NTSTATUS UsbDoInterruptTransfer(IN PUSBKBD_DEVICE_EXTENSION dx, IN PVOID UserBuffer, ULONGamp。 UserBufferSize){ //檢查Usb管道句柄是否可用，且輸入緩沖區(qū)是否大小合適 //否則就返回錯(cuò)誤狀態(tài)。 NTSTATUS status = STATUS_SUCCESS。 ULONG OutputBufferSize = 8。 // 為URB分配一個(gè)8字節(jié)的內(nèi)存 USHORT UrbSize = sizeof(struct _URB_BULK_OR_INTERRUPT_TRANSFER)。 PURB urb = (PURB)ExAllocatePool(NonPagedPool, UrbSize)。 //得到起始的時(shí)間計(jì)數(shù)，以用于檢查后來循環(huán)是否超時(shí)。 LARGE_INTEGER StartTickCount。 KeQueryTickCount( amp。StartTickCount)。 ULONG UnitsOf100ns = KeQueryTimeIncrement()。 //循環(huán)，得到鍵盤數(shù)據(jù)，并進(jìn)行處理。 while( true) { // 建立中斷傳輸請(qǐng)求。 UsbBuildInterruptOrBulkTransferRequest( urb, UrbSize, dxUsbPipeHandle, //指定管道句柄 UserBuffer, NULL, OutputBufferSize,//輸入數(shù)據(jù) USBD_TRANSFER_DIRECTION_IN, //指定為輸入方向 NULL)。 // 調(diào)用CallUSBDI，打開USB設(shè)備 status = CallUSBDI( dx, urb)。 //如果得到的數(shù)據(jù)為非0，則退出循環(huán)，因?yàn)槲覀兊玫降膶?shí)際的鍵盤數(shù)據(jù)。 if( urb!=OutputBufferSize) break。 __int64* pData = (__int64 *)UserBuffer。 //檢查是否超時(shí) LARGE_INTEGER TickCountNow。 KeQueryTickCount( amp。TickCountNow)。 ULONG ticks = (ULONG)( )。 if( ticks*UnitsOf100ns/10000000 = dxUsbTimeout) { status = STATUS_NO_MEDIA_IN_DEVICE。 break。 } }UserBufferSize＝urb。 //釋放內(nèi)存并返回狀態(tài)。ExFreePool(urb)。 return status。}控制傳輸分配和填寫URB發(fā)出URB釋放內(nèi)存記錄URB狀態(tài) 圖3－8 控制傳輸?shù)某绦蛄鞒?控制傳輸用來允許它的控制應(yīng)用程序修改鍵盤LED的狀態(tài)，這樣就可以說明如何在到端點(diǎn)0的缺省管道上進(jìn)行控制傳輸?！皩憽盜RP處理程序發(fā)送寫緩沖區(qū)的第一個(gè)字節(jié)給鍵盤，作為HID“輸出報(bào)告”。報(bào)告的低三位對(duì)應(yīng)于NumLock,CapsLock和ScrollLock鍵。 下面是控制傳輸函數(shù)UsbSendOutputReport（…）的偽代碼：const UCHAR SET_REPORT = 0x09。//定義常量報(bào)告字節(jié)NTSTATUS UsbSendOutputReport( IN PUSBKBD_DEVICE_EXTENSION dx, IN UCHAR OutputData){ // 分配URB內(nèi)存 USHORT UrbSize = sizeof(struct _URB_CONTROL_VENDOR_OR_CLASS_REQUEST)。 PURB urb = (PURB)ExAllocatePool(NonPagedPool, UrbSize)。 // 創(chuàng)建URB，通過缺省管道發(fā)送給類接口 UsbBuildVendorRequest(urb, URB_FUNCTION_CLASS_INTERFACE, UrbSize, USBD_TRANSFER_DIRECTION_OUT, // 指定為輸出方向 0, SET_REPORT, // 報(bào)告字節(jié) 0x0200, // 報(bào)告的類型 0, // 缺省的接口 amp。OutputData, NULL, 1, // 輸出的數(shù)據(jù) NULL)。 // 調(diào)用CallUSBDI，打開USB設(shè)備 NTSTATUS status = CallUSBDI( dx, urb)。 // 檢查返回狀態(tài)是否正確，否則返回打開USB設(shè)備錯(cuò)誤 if( !NT_SUCCESS(status) || !USBD_SUCCESS( urb)) { status = STATUS_UNSUCCESSFUL。 } //釋放內(nèi)存，返回狀態(tài) ExFreePool(urb)。 return status。}167。 主機(jī)應(yīng)用程序與虛擬設(shè)備的通信 其實(shí)驅(qū)動(dòng)程序設(shè)計(jì)完成之后，并不是就大功告成。驅(qū)動(dòng)程序只是底層驅(qū)動(dòng)設(shè)備讓其工作，真正要看驅(qū)動(dòng)程序完成什么功能，還要在應(yīng)用程序中通過與虛擬設(shè)備的通信，實(shí)現(xiàn)驅(qū)動(dòng)程序設(shè)計(jì)所實(shí)現(xiàn)的功能。 167。 程序設(shè)計(jì)的基本思想 與HID通信不像打開一個(gè)端口，設(shè)定幾個(gè)參數(shù)，然后就可以讀寫數(shù)據(jù)那么簡單。在應(yīng)用程序能與HID交換數(shù)據(jù)之前，它先要找到設(shè)備，獲取有關(guān)它的報(bào)告的信息。為做到這些，應(yīng)用程序必須通過訪問一系列API函數(shù)而跳過一些細(xì)節(jié)。應(yīng)用程序首先找到連接到系統(tǒng)的HID是什么，然后檢查細(xì)節(jié)，知道找到滿足要求的屬性。對(duì)于自定義設(shè)備來說，應(yīng)用程序能找到特定的供應(yīng)商和產(chǎn)品ID，和者應(yīng)用程序?qū)ふ以O(shè)備的特定類型，比如鼠標(biāo)和鍵盤。 找到設(shè)備后，應(yīng)用程序就可以通過收發(fā)報(bào)告來與設(shè)備交換信息了。 表3－3列出了建立通信以及和HID交換數(shù)據(jù)所使用的API函數(shù)。函數(shù)是以其被應(yīng)用程序調(diào)用的頻率的一般順序列出的。一些函數(shù)是訪問設(shè)備必須的，而其他則是提供可選信息。 表3－3 與HID通信使用的API函數(shù)API函數(shù)DLL目的HidD_GetHidGuid得到Hid類的GUIDSetupDiGetClassDevs返回包含一個(gè)特定類的所有設(shè)備的設(shè)備信息組SetupDiEnumDeviceInterfaces返回關(guān)于設(shè)備信息組中的一個(gè)設(shè)備的信息SetupDiDeviceInterfaceDetail返回一個(gè)設(shè)備路徑名CreateFile打開與一個(gè)設(shè)備的通信HidD_GetAttributes返回銷售商ID，產(chǎn)品ID等HidD_GetPreparsedData返回一個(gè)句柄到一個(gè)保存設(shè)備能力信息的緩沖器HidP_GetCaps返回描述設(shè)備能力的結(jié)構(gòu)HidP_GetValueCaps返回描述設(shè)備值能力的結(jié)構(gòu)HidP_GetButtonCaps返回描述設(shè)備能力按鈕的能力的結(jié)構(gòu)WriteFile發(fā)送一個(gè)報(bào)告給設(shè)備ReadFile從設(shè)備讀取報(bào)告CloseHandle關(guān)閉句柄SetupDiDestroyDeviceInfoList釋放SetupDiGetClassDevs使用的資源HidD_FreePreparsedData釋放HidD_GetPreparsedData使用的資源函數(shù)文檔分布在MSDN庫和Windows DDK中，不過2001－08的MSDN已經(jīng)包含上述所有函數(shù)的說明。UsbKbdTest程序測試UsbKbd驅(qū)動(dòng)程序。UsbKbdTest程序調(diào)用了上述的幾個(gè)Api函數(shù)，實(shí)現(xiàn)與設(shè)備的通信。UsbKbdTest做了以下的工作：1） 打開到支持USBKBD_GUID設(shè)備接口的第一個(gè)驅(qū)動(dòng)程序的句柄。2） 讀取設(shè)備描述符。3） 讀取配置描述符，接口描述符等。4） 讀取Hid報(bào)告描述符，類型0X22。5） 設(shè)置超時(shí)為15秒。6） 一直讀取鍵盤的輸入數(shù)據(jù)，知道按下Esc鍵（代碼0X29）。當(dāng)按下這些鍵時(shí)，輸出列表會(huì)顯示出來：Ctrl＋Alt＋Del，然后按A，B，C和Esc。7） 寫一系列的位組合來改變鍵盤LED燈的顯示，變化之間有1/3秒的延時(shí)。8） 讀設(shè)備，接口和端點(diǎn)狀態(tài)字。9） 讀幀長度和幀號(hào)。10） 關(guān)閉文件句柄。167。 部分程序代碼的說明 主程序太長了，現(xiàn)在要說明的是代碼部分是6和7，其余的用偽代碼說明，下面是部分代碼，其中說明部分已放在注釋里面。int main(int argc, char* argv[]){ int TestNo = 1。 //通過Usb鍵盤的GUID得到設(shè)備的句柄。 HANDLE hUsbKbd = GetDeviceViaInterface((LPGUID)amp。USBKBD_GUID,0)。 ………… //上面省略的部分是實(shí)現(xiàn)2，3，4的功能，由于不是很重要，故略去不提。 // 設(shè)置讀取超時(shí)時(shí)間15秒，實(shí)現(xiàn)第5部分的功能。 printf(\nTest %d\n,TestNo++)。 ULONG Timeout = 15。DeviceIoControl( hUsbKbd, IOCTL_USBKBD_SET_READ_TIMEOUT, amp。Timeout, sizeof(Timeout), // 輸入 NULL, 0, // 輸出 amp。BytesReturned, NULL)) // 讀鍵盤的數(shù)據(jù) DWORD TxdBytes。 BYTE KbdReport[8]。 // 循環(huán)直到Esc鍵盤按下 do { //如果ReadFile不成功，則返回錯(cuò)誤 //如果成功，則數(shù)據(jù)放在數(shù)組KbdRepo