Python/PyQt5如何对接FS Mini-Filter驱动内核通信端口

Python、PyQt5开发的用户态应用完全支持连接Mini-Filter驱动的内核通信端口，不存在语言层面的阻碍，也不是必须依赖Cython才能实现对接。

核心原理 #

FS Mini-Filter的用户态通信端口是Windows过滤管理器（Filter Manager）提供的标准通信机制，底层基于ALPC实现，用户态侧所有交互都通过fltlib.dll导出的几个标准Win32 API完成：FilterConnectCommunicationPort、FilterSendMessage、FilterGetMessage、FilterReplyMessage，这些都是系统原生导出的C接口，和开发语言没有绑定关系，只要能调用系统DLL导出函数的语言都可以对接，C++只是官方示例使用的开发语言而已。

可选实现路径 #

• 直接调用系统API（最常用，无需Cython）
  直接使用Python生态成熟的Win32调用库即可完成对接，不需要编写任何C/C++代码：
  • 可以用pywin32库，其已经封装了绝大多数fltlib相关的系统调用，文件过滤通信相关的接口在win32file模块下可以直接调用
  • 如果遇到个别没有封装的接口，用Python标准库ctypes直接加载fltlib.dll，声明对应函数的入参、返回值类型即可调用，全程不需要编译步骤
    PyQt5开发的GUI程序本质是标准的Win32用户态进程，和纯Python脚本调用这些API没有任何差异，只需要注意把通信逻辑放在独立工作线程执行，拿到消息后通过Qt信号槽转发给UI线程更新界面即可，不会存在兼容问题。消息结构体的序列化、反序列化直接用Python标准库struct模块处理即可，只要保证结构体对齐规则、字段顺序和内核驱动侧的定义完全一致，就能正常解析消息内容。
• 现成专用库情况
  目前PyPI上没有专门针对Mini-Filter通信端口封装的通用独立库，但pywin32提供的Win32 API封装已经完全覆盖通信所需的全部能力，实际开发中直接使用即可，不需要额外寻找专用库。
• Cython的适用场景
  只有两种场景才需要考虑使用Cython做对接：
  • 通信性能要求极高，单秒需要处理十万级以上的消息量，ctypes/pywin32的函数调用开销无法满足性能要求
  • 已经有成熟的C++实现的通信层逻辑，不想用Python重写连接管理、消息解析的整套代码
    普通业务场景（比如文件访问规则下发、拦截事件通知、简单配置交互）用ctypes/pywin32完全可以满足需求，不需要引入Cython增加开发复杂度。

开发注意事项 #

1. 架构必须匹配：如果编译的Mini-Filter驱动是64位版本，运行应用的Python解释器必须使用64位版本，32位进程无法连接64位驱动的通信端口，会直接返回架构不匹配错误
2. 权限要求：连接驱动通信端口的进程需要以管理员权限运行，否则连接接口会直接返回拒绝访问错误
3. 不要阻塞UI线程：FilterGetMessage是阻塞等待接口，必须放在独立工作线程中调用，不能直接放在PyQt的UI主线程执行，否则会导致界面无响应

内容的提问来源于stack exchange，提问作者hashy