Python调用C++ DLL并读取指针值方法

本文详解如何通过ctypes从Python安全调用C++ DLL中的指针参数函数，并准确获取DLL写入内存地址的返回值，避免常见误区（如直接打印byref对象导致输出无意义地址）。

本文详解如何通过ctypes从Python安全调用C++ DLL中的指针参数函数，并准确获取DLL写入内存地址的返回值，避免常见误区（如直接打印`byref`对象导致输出无意义地址）。

在Python中调用C++编写的DLL时，若函数通过指针参数（如 unsigned short*）修改调用方传入的变量，必须理解 ctypes 中“值”与“引用”的本质区别：ctypes.byref(x) 返回的是一个指向 x 内存的临时指针对象（），它本身不可直接打印出数值；真正存储数据的是被包装的 c_ushort() 实例，其值需通过 .value 属性显式读取。

以下为完整、健壮的调用示例：

import ctypes as ct
import ctypes.wintypes as w  # 提供标准Windows类型定义

# 推荐使用 CDLL（对应 __cdecl 调用约定），兼顾32/64位兼容性
# 若DLL明确导出为 __stdcall（如部分旧WinAPI风格），再选用 WinDLL
dll = ct.CDLL("C:/CFiles/test_dll/SimpleArg/x64/Debug/SimpleArg.dll")

# 绑定函数并声明签名
test_sizeKey = dll.test_sizeKey
test_sizeKey.argtypes = [ct.POINTER(ct.c_ushort)]  # 注意：列表形式更清晰，逗号结尾非必需
test_sizeKey.restype = w.BOOL  # 使用 w.BOOL（int型）而非 c_bool（1字节），避免类型不匹配风险

# 创建 ctypes 基础类型实例（非普通Python int！）
sizeKey = ct.c_ushort(0)  # 初始化为0，可选但推荐

# 传递指针：byref() 生成指向 sizeKey 的指针
result = test_sizeKey(ct.byref(sizeKey))

# ✅ 正确读取DLL写入的值
print(f"调用成功: {result}")           # 输出 True/False
print(f"DLL写入的值: {sizeKey.value}")  # 输出 150 —— 这才是目标结果

关键注意事项：

• ❌ 错误做法：print(sizeKey) 或 print(ct.byref(sizeKey)) —— 前者输出 ，后者输出 地址，均非实际数值；
• ✅ 正确做法：始终通过 .value 访问 c_ushort() 等 ctypes 实例的底层值；
• 类型一致性至关重要：C++ 中 unsigned short 必须严格对应 ct.c_ushort，BOOL 应映射为 w.BOOL（即 ct.c_int），而非 ct.c_bool（后者在Windows API中可能引发静默截断）；
• 若DLL路径含中文或空格，建议使用原始字符串（r"..."）或双反斜杠转义，防止路径解析错误。

掌握这一模式后，即可安全扩展至更复杂场景，如数组指针、结构体指针或回调函数传参，核心原则始终不变：ctypes 对象是内存容器，.value 是通往真实数据的唯一桥梁。