IOCTL_INTERNAL_I8042_HOOK_MOUSE

Operation

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

After I8042port receives an IOCTL_INTERNAL_MOUSE_CONNECT request, it sends a synchronous IOCTL_INTERNAL_I8042_HOOK_MOUSE request to the top of the keyboard device stack. When the upper-level filter driver receives this request, the filter driver sets the IsrRoutine member of the INTERNAL_I8042_HOOK_MOUSE structure that is passed with the request.

Input

The Parameters.DeviceIoControl.Type3InputBuffer points to an INTERNAL_I8042_HOOK_MOUSE structure. This structure includes an IsrRoutine member that points to the callback that is called by the I8042prt mouse ISR.

Output

None.

I/O Status Block

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

STATUS_SUCCESS: The request completed successfully.
STATUS_INVALID_PARAMETER: Parameters.DeviceIoControl.Type3InputBuffer is less than the size, in bytes, of an INTERNAL_I8042_HOOK_MOUSE structure.

Headers