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 }