stdcall (standard call) 是 microsoft windows 操作系统上广泛使用的一种调用约定，尤其在 win32 api 和 com (component object model) 接口中扮演着核心角色。它规定了函数参数的入栈顺序（从右到左），以及由被调用函数负责清理栈。在 go 语言中与这些底层 windows 组件进行交互时，理解并正确实现 stdcall 调用至关重要。本文将指导您如何利用 go 的 syscall 包来实现这一目标。
使用 syscall.Proc 进行函数调用
syscall.Proc 结构体提供了一种加载动态链接库 (DLL) 并获取其中导出函数指针的方法。这是进行 stdcall 调用的一个起点。
-
加载 DLL 并获取函数指针 首先，您需要使用 syscall.LoadLibrary 加载目标 DLL，然后通过 syscall.GetProcAddress 获取特定函数的地址。
package main import ( "fmt" "syscall" "unsafe" ) func main() { // 示例：调用 User32.dll 中的 MessageBoxW 函数 // 注意：实际开发中应检查错误，这里使用 MustLoadDLL/MustFindProc 简化 user32 := syscall.MustLoadDLL("User32.dll") messageBoxW := user32.MustFindProc("MessageBoxW") // MessageBoxW 参数 (stdcall): // HWND hWnd, LPCWSTR lpText, LPCWSTR lpCaption, UINT uType // 0, "Hello from Go", "Go stdcall", MB_OK captionPtr, _ := syscall.UTF16PtrFromString("Go stdcall") textPtr, _ := syscall.UTF16PtrFromString("Hello from Go!") // 调用 MessageBoxW // *Proc.Call 接受可变数量的 uintptr 类型参数 ret, _, _ := messageBoxW.Call( 0, // hWnd (通常为 0 表示桌面窗口) uintptr(unsafe.Pointer(textPtr)), uintptr(unsafe.Pointer(captionPtr)), uintptr(0x00000000), // MB_OK (对应 Winuser.h 中的常量) ) fmt.Printf("MessageBoxW 返回值: %d\n", ret) }在上述示例中，messageBoxW.Call() 方法被用于执行 stdcall 调用。该方法接受可变数量的 uintptr 类型参数，并返回三个值：第一个是函数返回值，第二个是错误码（通常在 errno 中），第三个是原始的系统错误对象。
*`Proc.Call的性能考量** 需要注意的是，*syscall.Proc.Call` 方法在每次调用时都会涉及内存的分配和释放。虽然对于不频繁的调用来说，这通常不是问题，但在性能敏感或高频调用的场景下，这种开销可能会变得显著。例如，如果您正在从 COM 接口的虚表中调用大量方法，或者在紧密循环中进行调用，那么这种开销就需要被考虑。
高效调用：syscall.Syscall 系列函数
为了避免 *Proc.Call 的内存开销，Go 语言提供了 syscall.Syscall、syscall.Syscall6、syscall.Syscall9 等一系列函数。这些函数直接封装了底层的系统调用，提供了更接近汇编级别的性能，适用于需要极致效率的场景。
-
函数签名与用法 这些函数的命名约定是 Syscall 加上其接受的 uintptr 参数数量（不包括第一个函数地址参数）。
- syscall.Syscall(trap, a1, a2, a3 uintptr)：用于最多 3 个参数的函数。
- syscall.Syscall6(trap, a1, a2, a3, a4, a5, a6 uintptr)：用于最多 6 个参数的函数。
- syscall.Syscall9(trap, a1, a2, a3, a4, a5, a6, a7, a8, a9 uintptr)：用于最多 9 个参数的函数。
- 等等，最多到 Syscall18。
所有这些函数都将第一个参数 trap 视为要调用的函数地址（uintptr 类型），后续参数则是传递给该函数的实参。它们返回三个值：r1, r2 和 err。r1 是函数的主要返回值，r2 是次要返回值（例如，在某些 Win32 API 中用于额外的错误信息），err 是系统错误码。
-
示例：使用 syscall.Syscall 调用函数 继续以 MessageBoxW 为例，使用 syscall.Syscall 调用：
package main import ( "fmt" "syscall" "unsafe" ) // 定义 MessageBoxW 的常量 const ( MB_OK = 0x00000000 ) func main() { // 获取 MessageBoxW 的函数地址 user32 := syscall.MustLoadDLL("User32.dll") messageBoxWProc := user32.MustFindProc("MessageBoxW") messageBoxWAddr := messageBoxWProc.Addr() // 获取函数地址 captionPtr, _ := syscall.UTF16PtrFromString("Go stdcall (Syscall)") textPtr, _ := syscall.UTF16PtrFromString("Hello from Go with Syscall!") // 使用 syscall.Syscall 调用 MessageBoxW // MessageBoxW 有 4 个参数 (hWnd, lpText, lpCaption, uType)，因此可以使用 syscall.Syscall6 r1, _, errno := syscall.Syscall6( messageBoxWAddr, // 第一个参数是函数地址 4, // 第二个参数是实际传递给 stdcall 函数的参数数量 0, // hWnd uintptr(unsafe.Pointer(textPtr)), uintptr(unsafe.Pointer(captionPtr)), uintptr(MB_OK), 0, 0, // 额外的参数，如果函数参数少于 SyscallX 的最大参数数，则用 0 填充 ) if errno != 0 { fmt.Printf("调用 MessageBoxW 失败: %v\n", syscall.Errno(errno)) } else { fmt.Printf("MessageBoxW 返回值: %d\n", r1) } }注意： syscall.SyscallX 系列函数的第二个参数（在 syscall.Syscall6 中为 4）通常是表示实际传递给 `std
