Skip to content

tankaishuai/win32exts_for_Lua

Repository files navigation

======================================

win32exts 多语言 外部编程接口扩展

脚本语言通用 Win32 FFI调用引擎简介

markdown

一直希望有这样的一种统一江湖的脚本语言:

既拥有脚本语言的动态解释执行能力,又拥有接近如C/C++般高效的执行效率,同时还具有如C/C++甚至汇编语言般强大的功能,可以直接调用系统功能。语言干净简练、子功能模块库丰富多彩,同时作为嵌入式脚本也能得心应手。

可惜没有!

常见的语言如lua, js, vbs, Python, PowerShell 都或多或少存在一些问题。PowerShell 语法过于诡异,

更接近于一种增强版的批处理脚本。Js/vbs/lua 使用方便,但原生功能较弱。Python拥有强大的第三方库,但打包部署麻烦。

于是,才有了大千世界、芸芸众生,各种语言的各领风骚。

言归正传。

笔者在开发过程中各种语言均有接触(当然更亲赖Python和Lua,毕竟作为嵌入式脚本非常合适)。经常摆在面前的问题是,

某语言在特定平台上需要直接调用系统API才能实现某些功能的问题。

当然,各种语言都有提供一些外部函数扩展(FFI)的方式。通常是需要自己编写一个模块(DLL)或者额外的脚本,难免有点愚拙。

所以此处只考虑一种无须额外写太多第三方库,实现统一调用任意系统API的机制。

目前主要流行的语言中,已有一些FFI支持库:

Pandao editor.md

各种扩展库语法差异极大,并且有些需要带上庞大数量的支持库,有些功能又极为简略,不能适应较为复杂的函数调用

(典型的如EnumWindows类带回调的,以及匿名函数、变参数目等的调用)。

因此,笔者开发的win32exts扩展框架旨在谋求一种 【发布简单】的(一个模块),【统一的】(各种脚本中语法基本一致),

【高效的】、【功能强大】 的(原生API,COM,C++非COM接口成员均支持)模式。

一句话,有了 win32exts,真正实现 Do whatever you want,放之四海而皆准是也。

以Python为例(其他语言其实差不多长一个样吧),

win32exts调用的基本用法如下:

(1)常规具名函数(以MessageBoxA/W为例)调用:

导入模块符号。第一个参数为待加载的模块名,可以带路径,传入"*"表示当前进程的所有模块;

第二个参数表示函数符号名称,传入"*"表示该模块的所有符号。

win32exts.load_sym("*", "*")

或 win32exts.load_sym("C:\windows\system32\user32.dll", "MessageBoxW")

或 win32exts.load_sym("user32", "MessageBoxA")

或 win32exts.load_sym("user32", "*")

win32exts.MessageBoxA(0, "call MessageBoxA", "", 1)

宽字符需要用 win32exts.L() 包装,与C/C++雷同。

win32exts.MessageBoxW(0, win32exts.L("call MessageBoxW"), None, 1)

(2)带回调的函数(以EnumWindows为例)调用:

先分配一块内存后面用:

g_buf = win32exts.malloc(2*260)

定义一个回调函数:

def EnumWndProc(args):   
	【args为参数包,以下取参数】
	hWnd = win32exts.arg(args, 1)
	lParam = win32exts.arg(args, 2)
	
	win32exts.GetWindowTextW(hWnd, g_buf, 260)
	【读取内存中的宽字符串】
	【read_***系列接口读内存,write_***系列接口写内存】
	strText = win32exts.read_wstring(g_buf, 0, -1)

	win32exts.MessageBoxW(0, win32exts.L(strText), g_buf, 1)

	strRetVal = "1, 8"
	g_index = g_index + 1
	if g_index > 3:   【假设只弹框三次】
		strRetVal = "0, 8"

	【返回值是形如这样的字符串: "回调返回值, 参数字节数",
	对于 cdecl 调用约定,参数字节数总是取 0 】
	return strRetVal

然后调用:

win32exts.EnumWindows(win32exts.callback("EnumWndProc"), 0)

win32exts.callback()用于包装一个Python回调函数。

对于js/lua 等等语言来说,没有提供该函数,直接传入即可,亦即:

win32exts.EnumWindows(EnumWndProc, 0)

(3)匿名(非具名)函数调用:

假设通过某个接口获取了某函数的地址 lFuncAddr,然后可以类似下述方式调用:

win32exts.push_value(arg1)     【参数是整数】
win32exts.push_wstring("arg2") 【参数是宽字符串】
win32exts.push_astring(arg3)   【参数是多字节字符串】
win32exts.push_double(arg4)    【参数是双精度浮点数】
win32exts.push_float(arg5)     【参数是单精度浮点数】
iRetVal = win32exts.call( lFuncAddr )

当然具名函数也可以类似调用,例如:

win32exts.push_value(0)

win32exts.push_astring("Py_MessageBoxA_V1")

win32exts.push_value(0)

win32exts.push_value(0)

iRetVal = win32exts.sym_call("MessageBoxA")  【或用 func_call】

实在编不下去了(←___←b'),下面是 win32exts 提供的接口分类清单, 至于典型用法请参考git上的 win32exts_for_Xxxx 仓库的demo 示例。

win32exts win32exts

当然,也可以通过 VS的对象查看器 或者 Python 的 win32exts.help() 命令查看详细API信息:

win32exts win32exts win32exts

About

Win32exts_for_Lua is a useful tool that allows you to call any Win32 API or User Export API or COM/AcriveX component in Lua.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published