【正文】 程序的結(jié)構(gòu)設(shè)計(jì)圖5－1HID USB鍵盤(pán)I/O請(qǐng)求處理由圖5－1可以看出，HID類與USB類之間的調(diào)用關(guān)系，鍵盤(pán)驅(qū)動(dòng)程序是系統(tǒng)中的一個(gè)中層驅(qū)動(dòng)，它的下層驅(qū)動(dòng)接口是USBDI，通過(guò)對(duì)USBDI的調(diào)用，實(shí)現(xiàn)對(duì)USB鍵盤(pán)的讀寫(xiě)操作，以及配置設(shè)備等。它的上層是HID類驅(qū)動(dòng)程序，本論文涉及的鍵盤(pán)驅(qū)動(dòng)程序要為上層的HID類驅(qū)動(dòng)程序提供接口。下面的兩節(jié)分別描述了對(duì)USB鍵盤(pán)的操作，和HID類小驅(qū)動(dòng)程序的實(shí)現(xiàn)。這兩者嵌套在一起，實(shí)現(xiàn)了一個(gè)完整的USB鍵盤(pán)驅(qū)動(dòng)。一個(gè)makefile工程是這樣的，它所編譯的文件都列在Sources文件中的宏里。Makefile工程有幾個(gè)設(shè)置文件，來(lái)設(shè)置編譯的環(huán)境和其他信息。VC＋＋的build項(xiàng)規(guī)定了將DriverEntry函數(shù)作為驅(qū)動(dòng)程序的入口，事實(shí)上這個(gè)入口可以通過(guò)修改build項(xiàng)來(lái)改變，但是這不重要。我們知道這個(gè)工程雖然沒(méi)有一個(gè)主函數(shù)，但是它的確是從DriverEntry開(kāi)始的。DriverEntry函數(shù)當(dāng)中規(guī)定了一些項(xiàng)，這些項(xiàng)規(guī)定了各個(gè)例程在哪個(gè)函數(shù)中。具體運(yùn)行的時(shí)候會(huì)找到這些代碼并執(zhí)行。 為了方便起見(jiàn)，我們將程序當(dāng)中的文件分為三種，一種是頭文件，第二種是實(shí)現(xiàn)文件，第三種是配置文件， ，，它們定義了一些結(jié)構(gòu)，象鍵盤(pán)報(bào)告描述符，系統(tǒng)中用到的函數(shù)定義等。 ， ， ， ，它們實(shí)現(xiàn)各個(gè)例程的函數(shù)。，MAKEFILE，Sources等，象MAKEFILE這樣的文件，它的內(nèi)容是不推薦改變的。MakeDrvr是一個(gè)設(shè)置環(huán)境變量的批處理文件，將在后面描述。 我們并不是十分關(guān)心函數(shù)在每個(gè)文件里是如何被放置的，在DriverEntry中已經(jīng)做了一些設(shè)置，還是取幾乎是公例的文件名和函數(shù)名的原因，是編寫(xiě)規(guī)范代碼的需要。一個(gè)函數(shù)名文件名規(guī)范，代碼編寫(xiě)規(guī)范的好的源碼，是便于調(diào)試和閱讀的。 調(diào)用USBDI實(shí)現(xiàn)USB鍵盤(pán)控制USB設(shè)備交互的第一件事是復(fù)位設(shè)備，確保設(shè)備可用。向USBDI發(fā)送IOCTL_INTERNAL_USB_GET_PORT_STATUS請(qǐng)求，獲取USB設(shè)備狀態(tài)信息。如果設(shè)備是未連接狀態(tài)，驅(qū)動(dòng)程序不會(huì)安裝。如果設(shè)備沒(méi)有處于使能狀態(tài)，就要發(fā)送IOCTL_INTERNAL_USB_RESET_PORT請(qǐng)求給USBDI來(lái)復(fù)位設(shè)備。USB設(shè)備在正常被使用以前,必須被配置，由主機(jī)負(fù)責(zé)配置設(shè)備。主機(jī)一般會(huì)從USB設(shè)備獲取配置信息后再判定此設(shè)備有哪些功能。，是配置設(shè)備的過(guò)程，首先要獲得設(shè)備的配置描述符（見(jiàn)UsbGetConfigurationDescriptors函數(shù)），然后找出接口，設(shè)備接口的每個(gè)管道的最大傳輸數(shù)據(jù)包為8，創(chuàng)建配置設(shè)備的URB請(qǐng)求發(fā)送給USBDI（見(jiàn)CreateConfigurationRequest函數(shù)），配置設(shè)備，配置設(shè)備成功之后保存配置句柄和管道句柄，以備將來(lái)使用讀鍵盤(pán)容易理解，寫(xiě)鍵盤(pán)則是設(shè)置鍵盤(pán)上的LED燈。另外需要提供一個(gè)數(shù)據(jù)緩沖區(qū)來(lái)保存數(shù)據(jù)，上一節(jié)提到最大數(shù)據(jù)包的大小為8，因此這個(gè)緩沖區(qū)的大小不能小于8字節(jié)，如果小于8字節(jié)，應(yīng)該提示出錯(cuò)。，USB鍵盤(pán)適合中斷傳輸方式，用創(chuàng)建URB的接口創(chuàng)建一個(gè)_URB_BULK_OR_INTERRUPT_TRANSFER類型的URB請(qǐng)求，發(fā)送到USBDI，處理之后，URB中就會(huì)有輸入的數(shù)據(jù)。完成IRP，將數(shù)據(jù)返回給請(qǐng)求者。讀操作完成（）。寫(xiě)操作是設(shè)置鍵盤(pán)上的LED燈，首先要?jiǎng)?chuàng)建一個(gè)_URB_CONTROL_VENDOR_OR_CLASS_REQUEST 類型的URB請(qǐng)求。然后發(fā)送給USBDI，USBDI處理這個(gè)請(qǐng)求，設(shè)置鍵盤(pán)上的LED燈，完成IRP，通知請(qǐng)求者，鍵盤(pán)的寫(xiě)操作完成（）。 為HID類提供接口從某種意義上可以說(shuō)，HID小驅(qū)動(dòng)程序提供了對(duì)HID類設(shè)備進(jìn)行操作的框架。在一些例程中，我們需要添加一些東西，來(lái)實(shí)現(xiàn)對(duì)HID類設(shè)備的操作。DriverEntry例程除了自己需要做的工作之外，它需要注冊(cè)成為HID小驅(qū)動(dòng)程序，注冊(cè)的示例代碼如下：代碼清單5－1 1DriverEntry例程externCNTSTATUSDriverEntry(PDRIVER_OBJECTDriverObject,PUNICODE_STRINGRegistryPath){ //例程的函數(shù)DriverObjectDriverExtensionAddDevice=AddDevice。DriverObjectDriverUnload=DriverUnload。DriverObjectMajorFunction[IRP_MJ_INTERNAL_DEVICE_CONTROL]=DispatchInternalControl。DriverObjectMajorFunction[IRP_MJ_PNP]=DispatchPnp。DriverObjectMajorFunction[IRP_MJ_POWER]=DispatchPower。 //注冊(cè)成為HID MinidriverHID_MINIDRIVER_REGISTRATIONreg。RtlZeroMemory(amp。reg,sizeof(reg))。=HID_REVISION。 =DriverObject。=RegistryPath。=sizeof(DEVICE_EXTENSION)。=FALSE。//以具體硬件為準(zhǔn)returnHidRegisterMinidriver(amp。reg)。}HidRegisterMinidriver是注冊(cè)的系統(tǒng)例程，可以看到首先是填寫(xiě)一個(gè)注冊(cè)HID小驅(qū)動(dòng)的結(jié)構(gòu)體HID_MINIDRIVER_REGISTRATION，然后用這個(gè)結(jié)構(gòu)體注冊(cè)。這個(gè)例程中有一些IOCTL，它們用來(lái)與HID設(shè)備交互。 節(jié)HIDCLASS小驅(qū)動(dòng)的IOCTL中，有對(duì)這幾個(gè)IOCTL的詳細(xì)描述。IOCTL_HID_GET_DEVICE_ATTRIBUTES這個(gè)IOCTL返回給HID類小驅(qū)動(dòng)程序設(shè)備屬性信息，程序填寫(xiě)一個(gè)PHID_DEVICE_ATTRIBUTES結(jié)構(gòu)，并將其返回。IOCTL_HID_GET_DEVICE_DESCRIPTOR這個(gè)IOCTL返回HID描述符，程序填充一個(gè)HID_DESCRIPTOR結(jié)構(gòu)，并將其返回。IOCTL_HID_GET_REPORT_DESCRIPTOR這個(gè)IOCTL給HID小驅(qū)動(dòng)程序返回報(bào)告描述符，將ReportDescriptor變量復(fù)制到HID類小驅(qū)動(dòng)程序的緩沖區(qū)。IOCTL_HID_READ_REPORT這個(gè)IOCTL是讀取鍵盤(pán)數(shù)據(jù)，程序清單如下：代碼清單5－2 IOCTL_HID_READ_REPOR if(outLen8) //不小于8字節(jié) { status = STATUS_BUFFER_TOO_SMALL。 break。 } if(dxbStarted==FALSE) { status = STATUS_DEVICE_NOT_READY。 break。 } if(Buffer==NULL) //緩沖區(qū)為空？ { status=STATUS_INVALID_PARAMETER。 break。 } IoMarkIrpPending(Irp)。 //置IRP為未處理 IoStartPacket(fdo,Irp,0,NULL)。 return STATUS_PENDING。 //返回未處理狀態(tài)先判斷緩沖區(qū)的大小是不是比最大值8小，如果小于8個(gè)字節(jié)，則返回錯(cuò)誤信息STATUS_BUFFER_TOO_SMALL，并退出。然后檢查系統(tǒng)線程的狀態(tài)，檢查緩沖區(qū)是否已經(jīng)有值，如果錯(cuò)誤，返回錯(cuò)誤信息并退出。接下來(lái)的IoMarkIrpPending函數(shù)是將IRP置為未處理狀態(tài)，然后放入隊(duì)列，返回未處理的狀態(tài)。IOCTL_HID_WRITE_REPORT是用來(lái)設(shè)置LED燈的，代碼如下：代碼清單5－3 IOCTL_HID_WRITE_REPORTif(inLensizeof(HID_XFER_PACKET) || Buffer == NULL) { status = STATUS_INVALID_PARAMETER。 break。 } IoMarkIrpPending(Irp)。 IoStartPacket(fdo,Irp,0,NULL)。 return STATUS_PENDING。首先需判斷格式的正確與緩沖區(qū)是否已經(jīng)有了數(shù)據(jù)，如果出錯(cuò)，則返回錯(cuò)誤信息，并退出處理。如果無(wú)誤，則將Irp置為未處理狀態(tài)，放入隊(duì)列，并返回未處理標(biāo)志。從這個(gè)處理過(guò)程可以看出，對(duì)于讀和寫(xiě)的操作，我們并沒(méi)有直接在處理IRP_MJ_INTERNAL_DEVICE_CONTROL例程的時(shí)候調(diào)用，注意到每次都調(diào)用IoStartPacket函數(shù)將Irp放到隊(duì)列中，StartIo例程對(duì)是讀或者寫(xiě)做出選擇，在系統(tǒng)線程中（）中進(jìn)行讀寫(xiě)操作。這個(gè)系統(tǒng)線程在設(shè)備啟動(dòng)的時(shí)候創(chuàng)建。 重要例程的實(shí)現(xiàn)設(shè)備驅(qū)動(dòng)程序是一個(gè)包含了許多操作系統(tǒng)可調(diào)用例程的容器，這些例程包括DriverEntry例程，AddDevice例程，Dispath例程，StartIo例程等。PnP管理器先裝入硬件需要的驅(qū)動(dòng)程序，然后再調(diào)用驅(qū)動(dòng)程序中的AddDevice函數(shù)。一個(gè)驅(qū)動(dòng)程序可以被多個(gè)類似的硬件使用，但驅(qū)動(dòng)程序的某些全局初始化操作只能在第一次被裝入時(shí)執(zhí)行一次。而DriverEntry例程就是用于這個(gè)目的。DriverEntry是內(nèi)核模式驅(qū)動(dòng)程序主入口點(diǎn)常用的名字。I/O管理器按下面方式調(diào)用該例程：extern C NTSTATUS DriverEntry(IN PDRIVER_OBJECT DriverObject, IN PUNICODE_STRING RegistryPath){ ...}DriverEntry的第一個(gè)參數(shù)是一個(gè)指針，指向一個(gè)剛被初始化的驅(qū)動(dòng)程序?qū)ο?，該?duì)象就代表你的驅(qū)動(dòng)程序。WDM驅(qū)動(dòng)程序的DriverEntry例程應(yīng)完成對(duì)這個(gè)對(duì)象的初始化并返回。DriverEntry的第二個(gè)參數(shù)是設(shè)備服務(wù)鍵的鍵名。這個(gè)串不是長(zhǎng)期存在的(函數(shù)返回后可能消失)，如果以后想使用該串就必須先把它復(fù)制到安全的地方。對(duì)于WDM驅(qū)動(dòng)程序的DriverEntry例程，其主要工作是把各種函數(shù)指針填入驅(qū)動(dòng)程序?qū)ο?。這些指針為操作系統(tǒng)指明了驅(qū)動(dòng)程序容器中各種子例程的位置。它們包括下面這些指針成員(驅(qū)動(dòng)程序?qū)ο笾?： DriverUnload 指向驅(qū)動(dòng)程序的清除例程。I/O管理器會(huì)在卸載驅(qū)動(dòng)程序前調(diào)用該例程。通常，WDM驅(qū)動(dòng)程序的DriverEntry例程一般不分配任何資源，所以DriverUnload例程也沒(méi)有什么清除工作要做。 DriverExtensionAddDevice 指向驅(qū)動(dòng)程序的AddDevice函數(shù)。PnP管理器將為每個(gè)硬件實(shí)例調(diào)用一次AddDevice例程。DriverStartIo 如果驅(qū)動(dòng)程序使用標(biāo)準(zhǔn)的IRP排隊(duì)方式，應(yīng)該設(shè)置該成員，使其指向驅(qū)動(dòng)程序的StartIo例程。 MajorFunction 是一個(gè)指針數(shù)組，I/O管理器把每個(gè)數(shù)組元素都初始化成指向一個(gè)啞派遣函數(shù)，這個(gè)啞派遣函數(shù)僅返回失敗。驅(qū)動(dòng)程序可能僅需要處理幾種類型的IRP，所以至少應(yīng)該設(shè)置與那幾種IRP類型相對(duì)應(yīng)的指針元素，使它們指向相應(yīng)的派遣函數(shù)。 通常，一個(gè)驅(qū)動(dòng)程序可以被多個(gè)設(shè)備利用。WDM驅(qū)動(dòng)程序有一個(gè)特殊的AddDevice函數(shù)，PnP管理器為每個(gè)設(shè)備實(shí)例調(diào)用該函數(shù)。該函數(shù)的原型如下：NTSTATUS AddDevice(PDRIVER_OBJECT DriverObject, PDEVICE_OBJECT pdo){}DriverObject參數(shù)指向一個(gè)驅(qū)動(dòng)程序?qū)ο?，就是你在DriverEntry例程中初始化的那個(gè)驅(qū)動(dòng)程序?qū)ο?。pdo參數(shù)指向設(shè)備堆棧底部的物理設(shè)備對(duì)象。對(duì)于功能驅(qū)動(dòng)程序，其AddDevice函數(shù)的基本職責(zé)是創(chuàng)建一個(gè)設(shè)備對(duì)象并把它連接到以pdo為底的設(shè)備堆棧中。相關(guān)步驟如下： （1）調(diào)用IoCreateDevice創(chuàng)建設(shè)備對(duì)象，并建立一個(gè)私有的設(shè)備擴(kuò)展對(duì)象。 （2）寄存一個(gè)或多個(gè)設(shè)備接口，以便應(yīng)用程序能知道設(shè)備的存在。另外，還可以給出設(shè)備名并創(chuàng)建符號(hào)連接。 （3）初始化設(shè)備擴(kuò)展和設(shè)備對(duì)象的Flag成員。 （4）調(diào)用IoAttachDeviceToDeviceStack函數(shù)把新設(shè)備對(duì)象放到堆棧上。Dispatch例程由I/O管理器定義如下：NTSTATUS(*PDRIVER_DISPATCH) (IN PDEVICE_OBJECT DeviceObject，IN PIRP Irp)；通常，大多數(shù)驅(qū)動(dòng)程序必須處理一些或者所有以下請(qǐng)求：LRP_MJ_PNP表明一個(gè)包括PnP設(shè)備識(shí)別的請(qǐng)求，硬件配置，或者資源分配的請(qǐng)求。這類請(qǐng)求顯然從PnP管理器或者從一個(gè)與較高層驅(qū)動(dòng)程序密切相關(guān)的設(shè)備發(fā)送到一個(gè)設(shè)備驅(qū)動(dòng)程序。IRP_MJ_POWER表明一個(gè)屬于設(shè)備或者系統(tǒng)的電源狀態(tài)請(qǐng)求。這類請(qǐng)求通過(guò)電源管理器或者一個(gè)密