reactos操作系统实现(94)

现在就来依次分析函数i8042Create、i8042Cleanup、i8042Close、i8042DeviceControl、i8042InternalDeviceControl和i8042Pnp。首先分析函数i8042Create，它的实现代码如下：

#001  NTSTATUS NTAPI

#002  i8042Create(

#003     IN PDEVICE_OBJECT DeviceObject,

#004     IN PIRP Irp)

#005  {

#006     TRACE_(I8042PRT, "IRP_MJ_CREATE/n");

#007 

 

设置IRP的状态为成功。

#008     Irp->IoStatus.Status = STATUS_SUCCESS;

 

返回状态信息为0。

#009     Irp->IoStatus.Information = 0;

 

调用函数IoCompleteRequest来设置当前IRP完成。

#010     IoCompleteRequest(Irp, IO_NO_INCREMENT);

#011     return STATUS_SUCCESS;

#012  }

 

函数i8042Cleanup，它的实现代码如下：

#001  NTSTATUS NTAPI

#002  i8042Cleanup(

#003     IN PDEVICE_OBJECT DeviceObject,

#004     IN PIRP Irp)

#005  {

#006     TRACE_(I8042PRT, "IRP_MJ_CLEANUP/n");

#007 

 

设置IRP的状态为成功。

#008     Irp->IoStatus.Status = STATUS_SUCCESS;

#009     Irp->IoStatus.Information = 0;

 

调用函数IoCompleteRequest来设置当前IRP完成。

#010     IoCompleteRequest(Irp, IO_NO_INCREMENT);

#011     return STATUS_SUCCESS;

#012  }

 

函数i8042Close，它的实现代码如下：

#001  NTSTATUS NTAPI

#002  i8042Close(

#003     IN PDEVICE_OBJECT DeviceObject,

#004     IN PIRP Irp)

#005  {

#006     TRACE_(I8042PRT, "IRP_MJ_CLOSE/n");

#007 

 

设置IRP的状态为成功。

#008     Irp->IoStatus.Status = STATUS_SUCCESS;

#009     Irp->IoStatus.Information = 0;

 

调用函数IoCompleteRequest来设置当前IRP完成。

#010     IoCompleteRequest(Irp, IO_NO_INCREMENT);

#011     return STATUS_SUCCESS;

#012  }

 

函数i8042DeviceControl，它的实现代码如下：

#001  static NTSTATUS NTAPI

#002  i8042DeviceControl(

#003     IN PDEVICE_OBJECT DeviceObject,

#004     IN PIRP Irp)

#005  {

#006     PFDO_DEVICE_EXTENSION DeviceExtension;

#007     NTSTATUS Status;

#008 

#009     TRACE_(I8042PRT, "i8042DeviceControl(%p %p)/n", DeviceObject, Irp);

 

获取设备扩展。

#010     DeviceExtension = (PFDO_DEVICE_EXTENSION)DeviceObject->DeviceExtension;

#011 

 

根设备类型来处理。

#012     switch (DeviceExtension->Type)

#013     {

 

这里处理键盘类型设备。

#014         case Keyboard:

#015             return i8042KbdDeviceControl(DeviceObject, Irp);

#016             break;

#017         default:

#018             return IrpStub(DeviceObject, Irp);

#019     }

#020 

#021     return Status;

#022  }

 

接着分析函数i8042KbdDeviceControl，它的实现代码如下：

#001  NTSTATUS NTAPI

#002  i8042KbdDeviceControl(

#003     IN PDEVICE_OBJECT DeviceObject,

#004     IN PIRP Irp)

#005  {

#006     PIO_STACK_LOCATION Stack;

#007     PI8042_KEYBOARD_EXTENSION DeviceExtension;

#008     NTSTATUS Status;

#009 

 

获取当前IRP的栈指针。

#010     Stack = IoGetCurrentIrpStackLocation(Irp);

 

设置返回状态信息为0个。

#011     Irp->IoStatus.Information = 0;

 

获取扩展设备。

#012     DeviceExtension = (PI8042_KEYBOARD_EXTENSION)DeviceObject->DeviceExtension;

#013 

 

根据IRP栈里的参数来获取操作码，然后根据操作码作不同的处理。

#014     switch (Stack->Parameters.DeviceIoControl.IoControlCode)

#015     {

 

获取系统的大写键状态。

#016         case IOCTL_GET_SYS_BUTTON_CAPS:

#017         {

#018             /* Part of GUID_DEVICE_SYS_BUTTON interface */

#019             PULONG pCaps;

#020             TRACE_(I8042PRT, "IOCTL_GET_SYS_BUTTON_CAPS/n");

#021 

 

如果返回参数内存空间不够4个字节长，就返回非法参数。

#022             if (Stack->Parameters.DeviceIoControl.OutputBufferLength != sizeof(ULONG))

#023                 Status = STATUS_INVALID_PARAMETER;

#024             else

#025             {

 

获取系统保存参数位置。

#026                 pCaps = (PULONG)Irp->AssociatedIrp.SystemBuffer;

 

把键盘的大写状态返回给系统。

#027                 *pCaps = DeviceExtension->NewCaps;

#028                 DeviceExtension->ReportedCaps = DeviceExtension->NewCaps;

 

设置IRP返回参数的长度为4个字节。

#029                 Irp->IoStatus.Information = sizeof(ULONG);

 

设置返回状态为成功。

#030                 Status = STATUS_SUCCESS;

#031             }

#032             break;

#033         }

 

获取系统按键事件。

#034         case IOCTL_GET_SYS_BUTTON_EVENT:

#035         {

#036             /* Part of GUID_DEVICE_SYS_BUTTON interface */

#037             PIRP WaitingIrp;

#038             TRACE_(I8042PRT, "IOCTL_GET_SYS_BUTTON_EVENT/n");

#039 

 

判断是否可以返回参数，如果不可以返回，就直接返回出错。

#040             if (Stack->Parameters.DeviceIoControl.OutputBufferLength != sizeof(ULONG))

#041                 Status = STATUS_INVALID_PARAMETER;

#042             else

#043             {

 

获取电源按键的事件。

#044                 WaitingIrp = InterlockedCompareExchangePointer(

#045                     &DeviceExtension->PowerIrp,

#046                     Irp,

#047                     NULL);

 

已经有一个事件的IRP在等待中，如果有就直接返回出错。

#048                 /* Check if an Irp is already pending */

#049                 if (WaitingIrp)

#050                 {

#051                     /* Unable to have a 2nd pending IRP for this IOCTL */

#052                     WARN_(I8042PRT, "Unable to pend a second IRP for IOCTL_GET_SYS_BUTTON_EVENT/n");

#053                     Status = STATUS_INVALID_PARAMETER;

#054                     Irp->IoStatus.Status = Status;

#055                     IoCompleteRequest(Irp, IO_NO_INCREMENT);

#056                 }

#057                 else

#058                 {

 

如果电源的IRP已经准备好，就直接返回给系统。

#059                     ULONG PowerKey;

#060                     PowerKey = InterlockedExchange((PLONG)&DeviceExtension->LastPowerKey, 0);

#061                     if (PowerKey != 0)

#062                     {

#063                         (VOID)InterlockedCompareExchangePointer(&DeviceExtension->PowerIrp, NULL, Irp);

#064                         *(PULONG)Irp->AssociatedIrp.SystemBuffer = PowerKey;

#065                         Status = STATUS_SUCCESS;

#066                         Irp->IoStatus.Status = Status;

#067                         Irp->IoStatus.Information = sizeof(ULONG);

#068                         IoCompleteRequest(Irp, IO_NO_INCREMENT);

#069                     }

#070                     else

#071                     {

#072                         TRACE_(I8042PRT, "Pending IOCTL_GET_SYS_BUTTON_EVENT/n");

#073                         Status = STATUS_PENDING;

#074                         Irp->IoStatus.Status = Status;

#075                         IoMarkIrpPending(Irp);

#076                     }

#077                 }

#078                 return Status;

#079             }

#080             break;

#081         }

 

缺省是调用函数ForwardIrpAndForget把IRP前面传送。

#082         default:

#083         {

#084             ERR_(I8042PRT, "IRP_MJ_DEVICE_CONTROL / unknown ioctl code 0x%lx/n",

#085                 Stack->Parameters.DeviceIoControl.IoControlCode);

#086             ASSERT(FALSE);

#087             return ForwardIrpAndForget(DeviceObject, Irp);

#088         }

#089     }

#090 

#091     Irp->IoStatus.Status = Status;

#092     if (Status == STATUS_PENDING)

 

这里调用函数IoMarkIrpPending来标记IRP正在阻塞中。

#093         IoMarkIrpPending(Irp);

#094     else

#095         IoCompleteRequest(Irp, IO_NO_INCREMENT);

#096 

#097     return Status;

#098  }

 

下面来分析函数i8042InternalDeviceControl的实现，代码如下：

#001  static NTSTATUS NTAPI

#002  i8042InternalDeviceControl(

#003     IN PDEVICE_OBJECT DeviceObject,

#004     IN PIRP Irp)

#005  {

#006     PFDO_DEVICE_EXTENSION DeviceExtension;

#007     ULONG ControlCode;

#008     NTSTATUS Status;

#009 

#010     TRACE_(I8042PRT, "i8042InternalDeviceControl(%p %p)/n", DeviceObject, Irp);

 

获取设备扩展。

#011     DeviceExtension = (PFDO_DEVICE_EXTENSION)DeviceObject->DeviceExtension;

#012 

 

根据设备扩展类型处理。

#013     switch (DeviceExtension->Type)

#014     {

 

不知道的类型处理。

#015         case Unknown:

#016         {

 

获取控制码。

#017             ControlCode = IoGetCurrentIrpStackLocation(Irp)->Parameters.DeviceIoControl.IoControlCode;

 

根据控制码来处理。

#018             switch (ControlCode)

#019             {

 

内部键盘连接处理。

#020                 case IOCTL_INTERNAL_KEYBOARD_CONNECT:

 

进行内部的IRP处理。

#021                     Status = i8042KbdInternalDeviceControl(DeviceObject, Irp);

#022                     break;

 

内部鼠标连接处理。

#023                 case IOCTL_INTERNAL_MOUSE_CONNECT:

#024                     Status = i8042MouInternalDeviceControl(DeviceObject, Irp);

#025                     break;

#026                 default:

#027                     ERR_(I8042PRT, "Unknown IO control code 0x%lx/n", ControlCode);

#028                     ASSERT(FALSE);

#029                     Status = STATUS_INVALID_DEVICE_REQUEST;

#030                     break;

#031             }

#032             break;

#033         }

 

键盘处理内部IRP。

#034         case Keyboard:

#035             Status = i8042KbdInternalDeviceControl(DeviceObject, Irp);

#036             break;

 

鼠标处理内部IRP。

#037         case Mouse:

#038             Status = i8042MouInternalDeviceControl(DeviceObject, Irp);

#039             break;

#040         default:

#041             ERR_(I8042PRT, "Unknown FDO type %u/n", DeviceExtension->Type);

#042             ASSERT(FALSE);

#043             Status = STATUS_INTERNAL_ERROR;

#044             IoCompleteRequest(Irp, IO_NO_INCREMENT);

#045             break;

#046     }

#047 

#048     return Status;

#049  }