windows98 - 2000驅(qū)動程序編寫方法下

1Windows98/2000驅(qū)動程序編寫方法（下）24.DriverWorks的使用1）生成簡單框架3工程文件名工程文件目錄4選擇驅(qū)動類型5創(chuàng)建功能驅(qū)動程序創(chuàng)建過濾器驅(qū)動程序6選擇相應總線本例不驅(qū)動硬件7驅(qū)動類名稱驅(qū)動類文件名8選擇需要處理的消息句柄9101112添加和應用程序之間通信的控制代碼131415測試用應用程序名稱161718驅(qū)動類設備類19驅(qū)動類文件設備類文件測試用的控制臺程序文件驅(qū)動安裝指導文件20

此時已經(jīng)具備了一個驅(qū)動程序以及做測試用的應用程序的基本框架，我們可以在VC集成環(huán)境下區(qū)修改有關(guān)程序，增加相關(guān)的具體操作代碼，然后就可以編譯和調(diào)試了。21

該驅(qū)動程序框架包含了幾個最基本的類，這些類是：classSample:publicKDriver//驅(qū)動程序類，用于初始化驅(qū)動程序{SAFE_DESTRUCTORSpublic:

//以下成員函數(shù)注意和WDM中有關(guān)例程聯(lián)系起來看

virtualNTSTATUSDriverEntry(PUNICODE_STRINGRegistryPath);virtualNTSTATUSAddDevice(PDEVICE_OBJECTPdo);void LoadRegistryParameters(KRegistryKey&Params);int m_Unit;//ThefollowingdatamembersareloadedfromtheregistryduringDriverEntry ULONGm_bBreakOnEntry;

};22classSampleDevice:publicKPnpDevice//是設備類KDvice的派生類，用于在WDM環(huán)境下支持即插即用設備{ //Constructorspublic: SAFE_DESTRUCTORS; SampleDevice(PDEVICE_OBJECTPdo,ULONGUnit); ~SampleDevice(); //MemberFunctions注意和PNP的次功能代碼聯(lián)系起來看public: DEVMEMBER_DISPATCHERS virtualNTSTATUSOnStartDevice(KIrpI); virtualNTSTATUSOnStopDevice(KIrpI); virtualNTSTATUSOnRemoveDevice(KIrpI); virtualNTSTATUSDefaultPnp(KIrpI); virtualNTSTATUSDefaultPower(KIrpI); virtualNTSTATUSOnDevicePowerUp(KIrpI); virtualNTSTATUSOnDeviceSleep(KIrpI); voidSerialRead(KIrpI); voidSerialWrite(KIrpI);23 NTSTATUSSAMPLE_IOCTL_Read_Handler(KIrpI); NTSTATUSSAMPLE_IOCTL_Write_Handler(KIrpI); NTSTATUSSAMPLE_IOCTL_ReadWrite_Handler(KIrpI);#ifdef_COMMENT_ONLY virtualNTSTATUSCreate(KIrpI); virtualNTSTATUSClose(KIrpI); virtualNTSTATUSDeviceControl(KIrpI); virtualNTSTATUSSystemControl(KIrpI); virtualNTSTATUSRead(KIrpI);

virtualNTSTATUSWrite(KIrpI);#endif

//MemberDataprotected:

//Unitnumberforthisdevice(0-9) ULONG m_Unit; KPnpLowerDevice m_Lower; SampleDevice_DriverManagedQueuem_DriverManagedQueue;//TODO: Createadditionaldrivermanagedqueues.Thesemightbe// ofthesameclass(SampleDevice_DriverManagedQueue),// oryoumightchoosetoderiveanotherclass.};24先編譯驅(qū)動程序工程在VC的集成環(huán)境中下面我們講解編譯、執(zhí)行和調(diào)試這個驅(qū)動程序。2526再編譯測試應用程序工程2728

下面使用DriverStudio帶的工具加載驅(qū)動程序和查看調(diào)試信息。驅(qū)動程序監(jiān)視，可就看到驅(qū)動程序發(fā)出的調(diào)試輸出語句驅(qū)動程序裝載器，可動態(tài)調(diào)用驅(qū)動程序29驅(qū)動程序監(jiān)視器界面30驅(qū)動程序裝載器界面31323334353637

下面我們來修改有關(guān)代碼，以便增加驅(qū)動程序和應用程序之間相互通信的內(nèi)容。需要增加的內(nèi)容包括：使用Read和Write方式分別從驅(qū)動程序讀入字符和向驅(qū)動程序?qū)懽址Ｊ褂肐O控制代碼方式分別從驅(qū)動程序讀入字符和向驅(qū)動程序?qū)懽址?。使用IO控制代碼方式向驅(qū)動程序?qū)懽址購尿?qū)動程序中讀出該字符串，并返回反饋串信息。

注意：程序中暗紅色顯示的部分是我們添加或修改過的語句，其他是DriverWorks自動生成的。語句中“t<<xxxxx”這樣的語句是向調(diào)試軟件輸出信息，該信息可以再DriverMonitor或其他調(diào)試監(jiān)視器中看到。2）完成應用程序和驅(qū)動程序之間的信息交換38使用Read和Write方式分別讀寫SampleDevice.cppvoidSampleDevice::SerialRead(KIrpI){ t<<"EnteringSampleDevice::SerialRead,"<<I<<EOL; NTSTATUSstatus =STATUS_SUCCESS; PUCHAR pBuffer =(PUCHAR)I.BufferedReadDest();//取得返回數(shù)據(jù)BUFF的指針

ULONGdwTotalSize=I.ReadSize(CURRENT); //Requestedreadsize charbuff[512]; intn=512,j=(n%26); for(inti=0;i<n;i++,j=(j+1)%26) { buff[i]='a'+j; } buff[dwTotalSize]=‘\0’;//指定串尾

strcpy((char*)pBuffer,buff);

//把給應用程序的數(shù)據(jù)拷貝給返回BUFF t<<“Thestringyouwherereadis\”“<<buff<<”\“”<<EOL;//輸出調(diào)試信息

ULONGdwBytesRead=strlen(buff); //Countofbytesread

I.Information()=dwBytesRead;//返回給應用程序的信息的字節(jié)個數(shù)

I.Status()=status; m_DriverManagedQueue.PnpNextIrp(I);}39voidSampleDevice::SerialWrite(KIrpI){ t<<"EnteringSampleDevice::SerialWrite,"<<I<<EOL; NTSTATUSstatus=STATUS_SUCCESS; PUCHARpBuffer=(PUCHAR)I.BufferedWriteSource();//取得存放應用程序?qū)懡o驅(qū)動程序的數(shù)據(jù)的BUFF的指針

ULONGdwTotalSize=I.WriteSize(CURRENT);//獲得應用程序?qū)懡o驅(qū)動程序的信息的字節(jié)數(shù)。

ULONGdwBytesSent=dwTotalSize;

charbuff[512]; strcpy(buff,(char*)pBuffer); //應用程序?qū)懡o驅(qū)動程序的數(shù)據(jù)在I.BufferedWriteSource()返回的指針中。

buff[dwBytesSent]='\0';

t<<"Writetodriveris\""<<buff<<"\""<<EOL; I.Information()=dwBytesSent;//返回用戶實際寫的字節(jié)數(shù)

I.Status()=status; m_DriverManagedQueue.PnpNextIrp(I);}40Test_Sample.cppvoiddoRead(intn)//從驅(qū)動程序中讀數(shù)據(jù){ char *buf; ULONGnRead; int i,j; buf=(char*)malloc(n); if(buf==NULL) { printf("Failedtoallocatebufferforread"); Exit(1); }

//Readdatafromdriver printf("Readingfromdevice-"); ReadFile(hDevice,buf,n,&nRead,NULL);

//參數(shù)分別是設備句柄、輸入緩沖地址、緩沖大小（字節(jié)數(shù)）、實際讀的數(shù)據(jù)字節(jié)數(shù)、覆蓋結(jié)構(gòu)指針。41 printf("%dbytesreadfromdevice(%drequested).\n",nRead,nRead); //Printwhatwasread while(i<nRead) {// j=min((i+26),n);// for(;i<j;i++)// {// printf("%c,",buf[i]);// }// printf("\n"); printf("%c,",buf[i++]); } printf("\n"); free(buf);}這幾句刪除42voiddoWrite(intn)//向驅(qū)動程序中寫數(shù)據(jù){ char *buf; ULONG nWritten; int i,j; buf=(char*)malloc(n); if(buf==NULL) { printf("Failedtoallocatebufferforwrite"); Exit(1); } //startwiththemod26letterofthenumberofbytestowrite j=(n%26); //loadbufferwithdummydata(abcdefg...) for(i=0;i<n;i++,j=(j+1)%26) { buf[i]='a'+j; }43

//Writedatatodriver printf("Writingtodevice-"); WriteFile(hDevice,buf,n,&nWritten,NULL);

//寫數(shù)據(jù),參數(shù)的含義是驅(qū)動程序句柄、寫緩沖、寫緩沖大小、實際驅(qū)動程序得到的信息的字節(jié)數(shù)、覆蓋結(jié)構(gòu)指針。

printf("%dbyteswrittentodevice(%dattempted).\n",nWritten,n); i=0;//Printwhatwaswritten while(i<n) { j=min((i+26),n); for(;i<j;i++){ printf("%c,",buf[i]); } printf("\n"); } free(buf);}44b.使用IO控制代碼方式分別讀寫SampleDevice.cppNTSTATUSSampleDevice::SAMPLE_IOCTL_Read_Handler(KIrpI){ //對應用程序讀驅(qū)動程序的請求作響應

NTSTATUSstatus=STATUS_SUCCESS; t<<"EnteringSampleDevice::SAMPLE_IOCTL_Read_Handler,"<<I<<EOL; charbuff1[512]; ULONGfwLength=0; strcpy(buff1,"etodriver!"); fwLength=strlen(buff1)+1; if(I.IoctlOutputBufferSize()>=fwLength) {//如果讀入緩沖夠長

strcpy((PCHAR)I.IoctlBuffer(),buff1); //將信息拷給應用程序讀入緩沖

I.Information()=fwLength; //返回信息長度

} else { I.Information()=0; //否則信息長度為0 t<<"buffsizetoosmall"<<EOL; } returnstatus;}45NTSTATUSSampleDevice::SAMPLE_IOCTL_Write_Handler(KIrpI){ //接受從應用程序中來的信息

NTSTATUSstatus=STATUS_SUCCESS; t<<"EnteringSampleDevice::SAMPLE_IOCTL_Write_Handler,"<<I<<EOL; charbuff[512]; ULONGfwLength=0; strcpy(buff,(PCHAR)I.IoctlBuffer());//拷貝從應用程序得到的命令串到驅(qū)動程序局部數(shù)據(jù)區(qū)

t<<“InputPutDatais\”“<<buff<<”\“”<<EOL; //顯示從應用程序得到的命令串。

I.Information()=0; returnstatus;}46Test_Sample.cppvoidTest_SAMPLE_IOCTL_Read(void){ CHAR bufInput[IOCTL_INBUF_SIZE]; //Inputtodevice CHAR bufOutput[IOCTL_OUTBUF_SIZE]; //Outputfromdevice ULONG nOutput; //CountwrittentobufOutput

//CalldeviceIOControlinterface(SAMPLE_IOCTL_Read)indriver printf("IssuingIoctltodevice-");

strcpy(bufInput,"Thisisasample.");

if(!DeviceIoControl(hDevice,SAMPLE_IOCTL_Read,NULL,

0, bufOutput,IOCTL_OUTBUF_SIZE,&nOutput,NULL)) { printf("ERROR:DeviceIoControlreturns%0x.",GetLastError()); Exit(1); }

else printf("Returnfromdriveris\"%s\"(%d)",bufOutput,nOutput);}47voidTest_SAMPLE_IOCTL_Write(void){ CHAR bufInput[IOCTL_INBUF_SIZE]; //Inputtodevice

CHAR bufOutput[IOCTL_OUTBUF_SIZE];//Outputfromdevice ULONG nOutput; //CountwrittentobufOutput //CalldeviceIOControlinterface(SAMPLE_IOCTL_Write)indriver printf("IssuingIoctltodevice-");

strcpy(bufInput,"Nowletuswritethisstring.");

if(!DeviceIoControl(hDevice,SAMPLE_IOCTL_Write,bufInput,

strlen(bufInput), NULL,0,&nOutput,NULL))//該函數(shù)參數(shù)分別是設備句柄、IO控制命令、寫緩沖、寫緩沖大小、讀緩沖、讀緩沖大小、實際讀的字節(jié)數(shù)、覆蓋結(jié)構(gòu)指針（注意，這里的bufInput是指Input到設備，所以對應用軟件這是寫緩沖，bufOutput是從設備output到應用程序，是讀緩沖。

{ printf("ERROR:DeviceIoControlreturns%0x.", GetLastError()); Exit(1); }}48c.使用IO控制代碼方式寫并且讀SampleDevice.cppNTSTATUSSampleDevice::SAMPLE_IOCTL_ReadWrite_Handler(KIrpI){ NTSTATUSstatus=STATUS_SUCCESS; t<<"EnteringSampleDevice::SAMPLE_IOCTL_ReadWrite_Handler,"<<I<<EOL; charbuff[512],buff1[512]; ULONGfwLength=0; strcpy(buff,(PCHAR)I.IoctlBuffer());//拷貝應用程序來的信息

t<<"InputPutDatais\""<<buff<<"\""<<EOL; strcpy(buff1,"thisisfeedbackfromdriver!Applicationgivemethisstring\""); strcat(buff1,buff); strcat(buff1,“\”“);//以上是組織反饋的信息49 fwLength=strlen(buff1)+1; if(I.IoctlOutputBufferSize()>=fwLength) { strcpy((PCHAR)I.IoctlBuffer(),buff1);//拷貝反饋信息

I.Information()=fwLength; //設置反饋信息字節(jié)數(shù)

} else { I.Information()=0; t<<"buffsizetoosmall"<<EOL; } returnstatus;}50Test_Sample.cppvoidTest_SAMPLE_IOCTL_ReadWrite(void){ bufOutputiswrittenbythedevicetoreturndatatothisapplication CHAR bufInput[IOCTL_INBUF_SIZE]; //Inputtodevice CHAR bufOutput[IOCTL_OUTBUF_SIZE]; //Outputfromdevice ULONG nOutput; //CountwrittentobufOutput //CalldeviceIOControlinterface(SAMPLE_IOCTL_ReadWrite)indriver printf("IssuingIoctltodevice-");

strcpy(bufInput,"Thisisasample."); if(!DeviceIoControl(hDevice,SAMPLE_IOCTL_ReadWrite,bufInput, strlen(bufInput),bufOutput, IOCTL_OUTBUF_SIZE,&nOutput,NULL)) { printf("ERROR:DeviceIoControlreturns%0x.",GetLastError()); Exit(1); } else printf("Feedbackis\"%s\"(%d)",bufOutput,nOutput);}5152533）直接對端口寄存器讀寫DriverStudio提供了KIoRange類來將外部總線的I/O地址空間范圍映射到處理器總線的地址空間范圍。該類的成員函數(shù)主要有KIoRange 構(gòu)造函數(shù)(4種格式)Initialize

初始化和重新初始化一個實例(3種格式)~KIoRange

析構(gòu)函數(shù)Invalidate

從已初始化狀態(tài)刪除該對象IsValid 測試該對象是否已經(jīng)初始化inb

讀一個或多個字節(jié)(2種形式)Outb 寫一個或多個字節(jié)(2種形式)Inw 讀一個或多個字(2種形式)Outw 寫一個或多個字(2種形式)ind 讀一個或多個雙字(2種形式)outd

寫一個或多個雙字(2種形式)54寫端口（OCW1，設置中斷屏蔽,地址21H）m_ParPortIos.outb(1,0x00);//OCW1，打開所有中斷讀端口（讀屏蔽寄存器，地址21H）

UCHARdata=m_ParPortIos.inb(1);下面我們來訪問8259A的屏蔽寄存器。首先定義類KIoRange的一個實例，以定義相關(guān)地址空間。

KIoRangem_ParPortIos;

初始化實例（指定8259A的端口首地址，并映射）

status=m_ParPortIos.