reactos操作系统实现(99)

下面来分析键盘的中断处理函数的实现，如下：

#001  BOOLEAN NTAPI

#002  i8042KbdInterruptService(

#003     IN PKINTERRUPT Interrupt,

#004     PVOID Context)

#005  {

#006     PI8042_KEYBOARD_EXTENSION DeviceExtension;

#007     PPORT_DEVICE_EXTENSION PortDeviceExtension;

#008     PKEYBOARD_INPUT_DATA InputData;

#009     ULONG Counter;

#010     UCHAR PortStatus, Output;

#011     BOOLEAN ToReturn = FALSE;

#012     NTSTATUS Status;

#013 

 

这个上下文参数，其实就是设备驱动程序里的设备扩展对象。

#014     DeviceExtension = (PI8042_KEYBOARD_EXTENSION)Context;

 

这里获取端口扩展属性。

#015     PortDeviceExtension = DeviceExtension->Common.PortDeviceExtension;

 

计算缓冲区里放入新按键位置。

#016     InputData = DeviceExtension->KeyboardBuffer + DeviceExtension->KeysInBuffer;

 

读取端口轮询的最大次数。

#017     Counter = PortDeviceExtension->Settings.PollStatusIterations;

#018 

#019     while (Counter)

#020     {

 

通过键盘端口读取状态。

#021         Status = i8042ReadStatus(PortDeviceExtension, &PortStatus);

#022         if (!NT_SUCCESS(Status))

#023         {

#024             WARN_(I8042PRT, "i8042ReadStatus() failed with status 0x%08lx/n", Status);

#025             return FALSE;

#026         }

 

读取键盘输入的数据。

#027         Status = i8042ReadKeyboardData(PortDeviceExtension, &Output);

#028         if (NT_SUCCESS(Status))

#029             break;

 

暂停一会再进入下一次尝试读取。

#030         KeStallExecutionProcessor(1);

#031         Counter--;

#032     }

 

轮询次数计数为0，那么说明读取键盘硬件失败。

#033     if (Counter == 0)

#034     {

#035         WARN_(I8042PRT, "Spurious i8042 keyboard interrupt/n");

#036         return FALSE;

#037     }

#038 

#039     INFO_(I8042PRT, "Got: 0x%02x/n", Output);

#040 

 

判断是否是CTRL + SCROLL组合键。

#041     if (PortDeviceExtension->Settings.CrashOnCtrlScroll)

#042     {

#043         /* Test for CTRL + SCROLL LOCK twice */

#044         static const UCHAR ScanCodes[] = { 0xe0, 0x1d, 0x46, 0xc6, 0x46, 0 };

#045 

#046         if (Output == ScanCodes[DeviceExtension->ComboPosition])

#047         {

#048             DeviceExtension->ComboPosition++;

#049             if (ScanCodes[DeviceExtension->ComboPosition] == 0)

#050                 KeBugCheck(MANUALLY_INITIATED_CRASH);

#051         }

#052         else if (Output == ScanCodes[0])

#053             DeviceExtension->ComboPosition = 1;

#054         else

#055             DeviceExtension->ComboPosition = 0;

#056     }

#057 

 

调用ISR的回调函数，如果已经处理这个按键就返回。

#058     if (i8042KbdCallIsrHook(DeviceExtension, PortStatus, Output, &ToReturn))

#059         return ToReturn;

#060 

 

处理键盘的数据是否需要重新输出到键盘。

#061     if (i8042PacketIsr(PortDeviceExtension, Output))

#062     {

#063         if (PortDeviceExtension->PacketComplete)

#064         {

#065             TRACE_(I8042PRT, "Packet complete/n");

#066             KeInsertQueueDpc(&DeviceExtension->DpcKeyboard, NULL, NULL);

#067         }

#068         TRACE_(I8042PRT, "Irq eaten by packet/n");

#069         return TRUE;

#070     }

#071 

#072     TRACE_(I8042PRT, "Irq is keyboard input/n");

#073 

 

到这里，已经说明是键盘输入数据。

#074     if (DeviceExtension->KeyboardScanState == Normal)

#075     {

 

判断扫描码是E0码，还是E1码。

#076         switch (Output)

#077         {

#078             case 0xe0:

#079                 DeviceExtension->KeyboardScanState = GotE0;

#080                 return TRUE;

#081             case 0xe1:

#082                 DeviceExtension->KeyboardScanState = GotE1;

#083                 return TRUE;

#084             default:

#085                 break;

#086         }

#087     }

#088 

 

更新输入的数据。

#089     /* Update InputData */

#090     InputData->Flags = 0;

 

置位是E0码，还是E1码。

#091     switch (DeviceExtension->KeyboardScanState)

#092     {

#093         case GotE0:

#094             InputData->Flags |= KEY_E0;

#095             break;

#096         case GotE1:

#097             InputData->Flags |= KEY_E1;

#098             break;

#099         default:

#100             break;

#101     }

 

设置按键是按下码，还是弹起码。

当键盘上有键被按下，松开，按住，键盘将产生扫描码( Scan Code )，这些扫描码将被  i8048 直接得到。扫描码有两种，Make Code 和 Break Code。当一个键被按下或按住时产生的是 Make Code ，当一个键被松开产生的是 Break Code。每个键被分配了唯一的 Make Code 和 Break Code ，这样主机通过扫描码就可以知道是哪一个键。简单的说就是按下键，产生一个 Make Code。松开键，产生一个 Break Code。

#102     DeviceExtension->KeyboardScanState = Normal;

#103     if (Output & 0x80)

#104         InputData->Flags |= KEY_BREAK;

#105     else

#106         InputData->Flags |= KEY_MAKE;

 

只需要保存低7F值。

#107     InputData->MakeCode = Output & 0x7f;

#108     InputData->Reserved = 0;

#109 

 

调用键盘队列返回包。其实这个函数是把数据放到环形缓冲区里，然后插入一个事件到DPC队列里，再由DPC队列来完成每个IRP包。

#110  DeviceExtension->KeyboardHook.QueueKeyboardPacket(DeviceExtension->KeyboardHook.CallContext);

#111 

#112     return TRUE;

#113  }

#114