IOCTL_INTERNAL_I8042_HOOK_MOUSE IOCTL

4/30/2018
2 minutes to read

The IOCTL_INTERNAL_I8042_HOOK_MOUSE request adds an ISR callback routine to the I8042prt mouse ISR. The ISR callback is optional and is provided by an upper-level mouse filter driver.

I8042prt sends this request after it receives an IOCTL_INTERNAL_MOUSE_CONNECT request. I8042prt sends a synchronous IOCTL_INTERNAL_I8042_HOOK_MOUSE request to the top of the mouse device stack.

After Moufiltr receives the hook mouse request, it filters the request in the following way:

Saves the upper-level information passed to Moufiltr, which includes the context of an upper-level device object and a pointer to an ISR callback
Replaces the upper-level information with its own
Saves the context of I8042prt and pointers to callbacks that the Moufiltr ISR callbacks can use

For more information about this request and the callbacks, see the following topics:

I8042prt Callback Routines

Moufiltr Callback Routines

Major Code

IRP_MJ_DEVICE_CONTROL

Input Buffer

The Parameters.DeviceIoControl.InputBufferLength member is set to a value greater than or equal to the size, in bytes, of an INTERNAL_I8042_HOOK_MOUSE structure.

The Parameters.DeviceIoControl.Type3InputBuffer points to an INTERNAL_I8042_HOOK_MOUSE structure that is allocated and set initially by I8042prt.

Input Buffer Length

The Parameters.DeviceIoControl.Type3InputBuffer points to an INTERNAL_I8042_HOOK_MOUSE structure that is allocated and set initially by I8042prt.

Output Buffer

None

Output Buffer Length

None

Status Block

The Status member is set to one of the following values:

Requirements


Header	ntdd8042.h (include Ntdd8042.h)