今天我们来聊一个 AutoHotkey v2 中被严重低估的超级能力——DLLCall。
如果 COM 是 AutoHotkey 与 Windows 组件对话的高级接口,那 DLLCall 就是直接操作机器码底层的汇编级通道。它不是”高级技巧”,而是让你突破 AutoHotkey 语言边界的核心基石。
一、DLLCall 的本质:你调的不是 API,是 CPU 指令
AutoHotkey v2 的脚本引擎本质是一个解释器。但当你写下 DllCall("kernel32\GetModuleHandle", "Ptr", 0) 时,发生的是:
- AHK 加载
kernel32.dll(如果尚未加载) - 定位
GetModuleHandle函数的入口地址 - 将参数压入调用栈(按调用约定)
- 执行
CALL指令——CPU 直接跳转到了 Windows 内核态代码 - 返回值通过寄存器
EAX/RAX传递回 AHK
这意味着: DLLCall 不是”AHK 帮你去调”,而是 AHK 告诉 CPU”你自己去调”。不存在 JavaScript 那种”跨语言桥接”性能损耗。DLLCall 的调用开销仅仅是参数编组(marshalling)和类型转换的几百纳秒。
v1 → v2 的重大变化
| 特性 | v1 | v2 |
|---|---|---|
| 参数类型声明 | DllCall("Func", "Int", 42) |
完全一致,但新增 "Int*" for output |
| 返回值类型 | 用 "Int" 前缀指定 |
用 "Int" 后缀参数 DllCall(..., "Int") |
| 结构体 | NumGet/Put + VarSetCapacity |
Buffer.Alloc() + NumGet/Put 统一 |
| 宽字符支持 | A_IsUnicode ? "W" : "A" |
始终 Unicode,直接 W 后缀 |
| 调用约定 | 默认 stdcall(32位) |
默认 stdcall,可用 CDecl 修饰 |
二、参数类型系统——你的”类型翻译器”
DLLCall 最难的部分不是调函数,而是告诉 AHK 如何翻译参数。类型标志就是你的翻译词典。
核心类型速查表
| 类型 | 大小 | 说明 |
|---|---|---|
"Int" |
4B | 有符号32位整数 |
"UInt" |
4B | 无符号32位整数 |
"Int64" |
8B | 64位有符号整数 |
"Ptr" |
4/8B | 指针(自动适应32/64位) |
"Str" |
可变 | 字符串指针(ANSI/Unicode自动转) |
"AStr" |
可变 | ANSI 字符串 |
"WStr" |
可变 | UTF-16 字符串 |
"Char" |
1B | 单字节字符 |
"Short" |
2B | 16位有符号整数 |
"Float" |
4B | 32位浮点数 |
"Double" |
8B | 64位浮点数 |
"UPtr" |
4/8B | 无符号指针 |
"Bool" |
4B | BOOL(非零=true) |
输出参数修饰符
在类型后加 * 表示”传入指针,期望函数写入数据”:
字符串参数的坑
字符串可能是 DLLCall 中最大的陷阱根源。AHK v2 内部字符串为 UTF-16。"Str" 参数类型会传递内部 UTF-16 指针(零拷贝!)。如果 API 期望 ANSI(如旧版 Windows API),必须用 "AStr"。如果 API 写入字符串缓冲区,用 "Str" 配合 Buffer 分配空间。
三、Buffer 对象——v2 的内存管理革命
Buffer 是 v2 最重要的新增类型之一,替代了 v1 所有”用字符串当内存”的 hack。
Buffer.Alloc 基础
不再需要 v1 的 VarSetCapacity + 手动清零:
四、结构体的定义与操作
Windows API 大量使用 C 结构体。在 AHK v2 中,你需要自己计算偏移量。
手动布局(精确控制)
以 RECT 结构为例(Win32 定义),包含 left、top、right、bottom 四个 LONG 字段,总大小为 16 字节。
包含嵌套结构体
以 POINT 和 WINDOWPLACEMENT 为例,WINDOWPLACEMENT 包含 POINT 和 RECT 两个子结构,总大小为 44 字节。
五、实战案例(部分代码免费展示)
案例1:获取精确窗口信息(系统挂钩级)
GetWindowPlacement 可以获取窗口的精确位置,包括”最小化/最大化”状态,比 WinGetPos 更底层。它返回窗口的显示命令状态,1=正常,2=最小化,3=最大化。
案例2:枚举系统进程(PSAPI 方式)
COM 的 Win32_Process WMI 查询很慢。用 PSAPI 原生 API 快 10 倍以上:
案例3:硬件信息读取(CPUID)
直接调用 CPUID 指令比读注册表更可靠,可以获取 CPU 厂商字符串(GenuineIntel / AuthenticAMD 等)。
案例4:高性能内存读写(跨进程)
使用 ReadProcessMemory 读取其他进程内存。需要管理员权限。可以读取任意进程的任意内存地址,注意:64位进程读取32位进程的内存时地址处理有所不同。
案例5:系统全局 HOOK(低级键盘钩子)
用 SetWindowsHookExW 安装全局键盘监听——比 AHK 自带的 InputHook 更底层,可以捕获系统级别的键击事件,包括被其他程序拦截的按键。
案例6:原始输入(Raw Input)——最精确的鼠标/键盘数据
比 OnMessage 更底层,可以获取设备硬件信息,包括鼠标移动的原始增量数据和按钮状态。
六、调用约定的陷阱与解决方案
这是 DLLCall 最隐蔽的坑,不处理好会导致栈损坏 → AHK 崩溃。
x86 下的三种调用约定
| 约定 | 参数传递 | 清理者 | 特征 |
|---|---|---|---|
| stdcall | 栈(从右到左) | 被调函数 | 默认,Windows API 标准 |
| cdecl | 栈(从右到左) | 调用者 | C 运行时库(msvcrt) |
| thiscall | ECX + 栈 | 被调函数 | C++ 成员函数 |
x64 Windows 只用一种调用约定:Microsoft x64 calling convention。参数通过 RCX/RDX/R8/R9 传递,多余参数压栈。DLLCall 自动处理,你不用担心。但注意:x64 下所有指针都是 8 字节,务必用 "Ptr" 而非 "Int"。
七、DLLCall 高级技巧
1. 函数地址缓存(高性能)
重复调用的 DLLCall,缓存函数地址可避免每次查找。
2. DllCall 中的回调
当你传入 CallbackCreate 创建的指针时,注意回调触发时 AHK 的消息循环必须运行。
3. 宽字符字符串的零拷贝传递
AHK v2 内部字符串就是 UTF-16,传递 "Str" 参数时 不会拷贝字符串。但注意对写入型 API,传 "Str" 可能意外修改 AHK 内部字符串,务必用 Buffer 隔离。
八、调试 DLLCall 的黄金法则
- 检查
A_LastError - 确认位数匹配:32位 AHK 不能用
"Int64"存指针 - 确认调用约定:C 运行时库函数必须加
CDecl - 确认结构体大小:结构体位对齐(packing)可能导致偏移错误
- 用 Process Monitor 验证:查看是否加载了正确的 DLL
结语
DLLCall 是 AutoHotkey v2 中最接近”机器码编程”的能力。它让你能调用 Windows 底层 API 的 100%,不受 AHK 功能边界限制。
但能力越大责任越大:
- 每个
"Ptr"参数都是潜在崩溃点——传递错误地址会让整个进程挂掉 - 回调函数中的错误会导致进程退出,而非仅抛出异常
- 64 位和 32 位的
"Ptr"大小不同,脚本必须考虑兼容性
掌握 DLLCall,意味着你不再是一个”用 AHK 写脚本”的人,而是一个通过 AHK 直接操控操作系统的人。这是从”中级用户”跃升为”AHK 工程师”的标志。
> 在下一篇文章中,我们将深入 AHK v2 的 CallbackCreate 高级模式——如何安全创建 C 语言回调、避免内存泄漏、实现 C++ 虚函数表劫持。

