Python在Windows下通过ctypes调用SetWindowsHookEx监听键盘鼠标

实现原理与准备工作

在Windows系统中，监听全局键盘和鼠标事件通常需要使用低级钩子（Low-Level Hooks）。Python标准库中的ctypes模块允许我们直接调用Windows动态链接库（DLL）中的函数。为了实现这一功能，我们需要安装pypiwin32库，它提供了访问Windows API所需的宏定义和接口。

pip install pypiwin32

核心代码实现

以下代码展示了如何使用ctypes调用SetWindowsHookEx函数来设置键盘和鼠标钩子。代码中定义了键盘和鼠标的回调函数，并在事件发生时进行相应的处理。

# coding=utf-8
from ctypes import *
from ctypes import wintypes
import win32con

SetWindowsHookEx=windll.user32.SetWindowsHookExA
UnhookWindowsHookEx=windll.user32.UnhookWindowsHookEx
CallNextHookEx=windll.user32.CallNextHookEx
GetMessage=windll.user32.GetMessageA
GetModuleHandle=windll.kernel32.GetModuleHandleW
#保存键盘钩子函数句柄
keyboard_hd = None
#保存鼠标钩子函数句柄
mouse_hd = None


class KBDLLHOOKSTRUCT(Structure):
  _fields = [
    ('vkCode',c_int),
    ('scanCode', c_int),
    ('flags', c_int),
    ('time', c_int),
    ('dwExtraInfo', c_uint),
    ('',c_void_p)
  ]


class POINT(Structure):
  _fields = [
    ('x',c_long),
    ('y',c_long)
  ]


class MSLLHOOKSTRUCT(Structure):
  _fields = [
    ('pt',POINT),
    ('hwnd',c_int),
    ('wHitTestCode',c_uint),
    ('dwExtraInfo',c_uint),
  ]


def wait_for_msg():
  msg = wintypes.MSG()
  GetMessage(msg, 0, 0, 0)


def keyboard_pro(nCode, wParam, lParam):
  """
  函数功能：键盘钩子函数，当有按键按下时此函数被回调
  """
  if nCode == win32con.HC_ACTION:
    KBDLLHOOKSTRUCT_p = POINTER(KBDLLHOOKSTRUCT)
    param=cast(lParam,KBDLLHOOKSTRUCT_p)
    print(param.contents.vkCode)
  return CallNextHookEx(keyboard_hd, nCode, wParam, lParam)


def start_keyboard_hook():
  """
  函数功能：启动键盘监听
  """
  HOOKPROTYPE = CFUNCTYPE(c_int, c_int, c_int, POINTER(c_void_p))
  pointer = HOOKPROTYPE(keyboard_pro)
  keyboard_hd = SetWindowsHookEx(
    win32con.WH_KEYBOARD_LL,
    pointer,
    GetModuleHandle(None),
    0)
  wait_for_msg()


def stop_keyboard_hook():
  """
  函数功能：停止键盘监听
  """
  UnhookWindowsHookEx(keyboard_hd)


def mouse_pro(nCode, wParam, lParam):
  """
  函数功能：鼠标钩子函数，当有鼠标事件，此函数被回调
  """
  if nCode == win32con.HC_ACTION:
    MSLLHOOKSTRUCT_p = POINTER(MSLLHOOKSTRUCT)
    param=cast(lParam,MSLLHOOKSTRUCT_p)
    #鼠标左键点击
    if wParam == win32con.WM_LBUTTONDOWN:
      print("左键点击，坐标：x:%d,y:%d" % (param.contents.pt.x,param.contents.pt.y))
    elif wParam == win32con.WM_LBUTTONUP:
      print("左键抬起，坐标：x:%d,y:%d" % (param.contents.pt.x, param.contents.pt.y))
    elif wParam == win32con.WM_MOUSEMOVE:
      print("鼠标移动，坐标：x:%d,y:%d" % (param.contents.pt.x, param.contents.pt.y))
    elif wParam == win32con.WM_RBUTTONDOWN:
      print("右键点击，坐标：x:%d,y:%d" % (param.contents.pt.x, param.contents.pt.y))
    elif wParam == win32con.WM_RBUTTONUP:
      print("右键抬起，坐标：x:%d,y:%d" % (param.contents.pt.x, param.contents.pt.y))
  return CallNextHookEx(mouse_hd, nCode, wParam, lParam)


def start_mouse_hook():
  """
  函数功能：启动鼠标监听
  """
  HOOKPROTYPE = CFUNCTYPE(c_int, c_int, c_int, POINTER(c_void_p))
  pointer = HOOKPROTYPE(mouse_pro)
  mouse_hd = SetWindowsHookEx(
    win32con.WH_MOUSE_LL,
    pointer,
    GetModuleHandle(None),
    0)
  wait_for_msg()


def stop_mouse_hook():
  """
  函数功能：停止鼠标监听
  """
  UnhookWindowsHookEx(mouse_hd)

运行与验证

将上述代码保存为HookApi.py，然后创建另一个Python脚本调用该模块中的函数来启动监听。例如，以下代码启动了键盘监听：

import HookApi

if __name__== '__main__':
  HookApi.start_keyboard_hook()

运行该脚本后，系统会开始监听键盘事件。当有按键按下时，控制台会输出对应的虚拟键码。同样，可以调用start_mouse_hook()来启动鼠标监听，此时控制台会输出鼠标事件的类型和坐标。

注意事项

• 使用WH_KEYBOARD_LL和WH_MOUSE_LL钩子可以监听全局事件，但需要注意性能影响。
• 钩子函数必须在主线程中运行，否则可能无法正确捕获事件。
• 在停止监听时，务必调用UnhookWindowsHookEx函数释放钩子，以避免资源泄漏。

以上就是Python监听键盘和鼠标事件的详细内容，更多关于Python系统编程的资料请关注本站其它相关文章！