Moufiltr

[This is preliminary documentation and subject to change.]

SUMMARY

This driver filters input for a particular mouse on the system. In its current state, it only hooks into the mouse packet report chain and the mouse ISR, but does not do any processing of the data that it sees. (The hooking of the ISR is only available in the i8042prt stack.) With additions to this current filter-only code base, the filter could conceivably add, remove, or modify input as needed.

It works on both x86 and Alpha platforms, and is 64-bit compliant.

This sample is installed via an .inf file. The .inf file included in this sample is designed to filter a PS/2 mouse.

Use the following rules regarding the .inf file that installs the filter driver.

• The .inf file must install the class driver (Mouclass) and the port driver (i8042prt, Mouhid, Sermouse, etc.) by using Msmouse.inf and the INF directives "Needs" and "Include".
• The .inf file must add the correct registry values for the class and port driver, as well as using the new directives.

The .inf (moufiltr.inf) included in this example was generated by Geninf.exe, a tool located in the Tools directory. An .inf file generated by Geninf.exe will contain the necessary directives to install a new mouse filter driver. Use Geninf.exe to create the .inf file for your driver.

The catalog file referred to in moufiltr.inf, Kbfiltr.cat, is included in this example, but it is invalid. WHQL will provide a valid catalog file upon approval of the driver.

1. Open the Device Manager.
2. Open the Properties of the PS/2 mouse installed on the system.
3. Click the Driver tab, and then click Update Driver.
4. Follow the wizard's prompts, and when prompted, select the Display a list of the known drivers option. Then click Next.
5. Click Have Disk and then point to the location of the .inf file.
6. Proceed through the rest of the install. You will need to reboot the machine if you are filtering a PS/2 device.

Once built, the sample produces one binary: Moufiltr.sys.

The code builds properly with Microsoft® Visual C® 6.0 and the driver supports Plug and Play and Power Management. Both checked and free builds are available. There are no known bugs or issues to be documented.

CODE TOUR

File Manifest