调用 C 编写的 DLL 函数：Go 语言教程

本文介绍了在 Go 语言中调用使用 C 语言编写的动态链接库 (DLL) 函数的几种方法。主要涵盖使用 cgo 和 syscall 两种方式，并提供了相应的代码示例。通过学习本文，你将能够掌握在 Go 项目中集成现有 C 代码的方法，从而扩展 Go 语言的功能。

在 Go 语言中调用 C 编写的 DLL 函数，主要有以下几种方法：

1. 使用 cgo

cgo 是 Go 语言提供的一种机制，允许 Go 代码调用 C 代码。它通过 “链接” 到 DLL 库来实现函数调用。这是相对来说比较方便和直接的方法。

示例：

首先，需要在 Go 代码中导入 “C” 包：

import "C"

然后，可以直接调用 C 函数，就像它们是 Go 函数一样：

//export SomeDllFunc func SomeDllFunc(arg1 C.int, arg2 *C.char) C.int {     // 在这里实现 C 函数的逻辑     return 0 }

注意:

• 需要使用 //export SomeDllFunc 注释来声明要导出的 C 函数。
• 在 Go 文件中，可以使用 C.SomeDllFunc(…) 来调用 C 函数。
• 需要将 C 代码放在 Go 文件中，或者单独的 C 文件中，并在编译时链接到 DLL。
• 使用 cgo 需要安装 C 编译器（如 GCC）。

优点：

• 语法简洁，易于理解。
• 与 Go 代码集成度高。

缺点：

• 需要安装 C 编译器。
• 编译过程相对复杂。

2. 使用 syscall 包

syscall 包提供了对底层操作系统调用的访问。可以使用它来加载 DLL，获取函数地址，并调用函数。

示例：

package main  import (     "fmt"     "syscall"     "unsafe" )  func main() {     // 加载 kernel32.dll     kernel32, err := syscall.LoadLibrary("kernel32.dll")     if err != nil {         fmt.Println("LoadLibrary error:", err)         return     }     defer syscall.FreeLibrary(kernel32)      // 获取 GetModuleHandleW 函数的地址     getModuleHandle, err := syscall.GetProcAddress(kernel32, "GetModuleHandleW")     if err != nil {         fmt.Println("GetProcAddress error:", err)         return     }      // 调用 GetModuleHandleW 函数     var nargs uintptr = 0     ret, _, callErr := syscall.Syscall(uintptr(getModuleHandle), nargs, 0, 0, 0)     if callErr != 0 {         fmt.Println("Syscall error:", callErr)         return     }      fmt.Printf("Module Handle: 0x%xn", ret) }

代码解释：

1. syscall.LoadLibrary(“kernel32.dll”): 加载名为 “kernel32.dll” 的 DLL 文件。
2. syscall.GetProcAddress(kernel32, “GetModuleHandleW”): 获取 DLL 中名为 “GetModuleHandleW” 的函数的地址。
3. syscall.Syscall(uintptr(getModuleHandle), nargs, 0, 0, 0): 使用系统调用来执行函数。uintptr(getModuleHandle) 是函数地址，nargs 是参数个数，后面的 0, 0, 0 是传递给函数的参数。

优点：

• 不需要安装 C 编译器。
• 可以更灵活地控制底层操作。

缺点：

• 代码相对复杂，需要更多地了解底层细节。
• 错误处理比较繁琐。

3. 注意事项

• 参数类型转换： 在 C 和 Go 之间传递参数时，需要进行类型转换。例如，C 的 int 对应 Go 的 C.int，C 的 char* 对应 Go 的 *C.char。
• 内存管理： 需要注意内存管理。如果在 C 代码中分配了内存，需要在 Go 代码中释放。可以使用 C.free() 函数来释放 C 分配的内存。
• 错误处理： 需要仔细处理错误。syscall 包返回的错误信息可能比较底层，需要进行适当的转换和处理。
• 字符编码： 在 Windows 上，很多 API 使用 Unicode 编码。需要使用 syscall.UTF16PtrFromString 函数将 Go 字符串转换为 UTF-16 编码的字符串。

总结

本文介绍了在 Go 语言中调用 C 编写的 DLL 函数的两种主要方法：cgo 和 syscall。cgo 更加简洁方便，适用于简单的函数调用。syscall 更加灵活，适用于需要更精细控制的场景。选择哪种方法取决于具体的应用需求。在实际使用中，需要注意参数类型转换、内存管理和错误处理等问题。希望本文能够帮助你更好地在 Go 项目中集成 C 代码。

更详细的信息，可以参考 Go 官方 Wiki：https://www.php.cn/link/426281d73409354c214025722c6160a8