python 调用dll 动态链接库 结构体参数及回调函数等示例

结构体示例：

这里是 C 代码的部分，主要是结构体的声明和回调函数定义。

// 新版本定义
typedef enum {
    DevCard,
    DevLocator,
    DevReader
} DevType;

typedef enum {
    MsgLocate,      // 定位信号
    MsgCut,         // 剪断信号
    MsgHeartBeat,   // 心跳信号
    MsgCall,        // 呼叫信号
    MsgShake,       // 震动信号
    MsgLeave,       // 离开信号
    MsgOffAlarm,    // 报警灯关闭信号
    MsgCheckPower,  // 电量检测信号
    MsgHeartRate,   // 心率信号
    MsgExtra,       // 补发信号
    MsgNoPower,     // 没电信号
    MsgReset,       // 重置信号
    MsgBoundary,    // 跨界信号
    // 此消息会跟随着MsgLocate消息出现
    MsgPower,
    // 当checkOffline设置为1时有效。如果在offlineTime时间内没有收到此设备的信号，则发出离线信号
    MsgOffline,
    MsgLast
} MsgType;

// 由于消息类型的不同，不是所有的值都有意义
typedef struct {
    MsgType type;
    DevType device;         // 硬件类型
    int32_t cardID;         // 标签/腕带ID,当DevType为DevCard时有意义
    int32_t readerID;       // 阅读器ID，总是有意义
    int32_t locatorID;      // 大于0时有意义，表示定位器ID
    int32_t readerRSSI;     // 阅读器信号强度，由于硬件版本的差异，此值要么全有意义，要么全没意义(总是0)
    int32_t locatorRssiX;   // 当MsgType为[MsgLocate, MsgExtra]时，此值有意义，表示定位器的信号强度
    int32_t locatorRssiY;   // 定位器的信号强度
    uint8_t isCut;          // 如果此值为1，表示硬件被破坏。因为有专门的MsgCut消息，可以忽视此值
    uint8_t isShake;        // 如果此值为1，表示硬件处于震动状态。仅当MsgType为MsgShake是有意义，1表示震动，0表示静止
    uint8_t isLowpower;     // 硬件是否低电。硬件为标签时有意义，因为有追加的MsgPower消息，可以在MsgType为MsgPower时使用此值
    int32_t heartRate;      // 心率，当MsgType为[MsgHeartBeat, MsgHeartRate]之一时有意义
    int32_t power;          // 电量，当MsgType为[MsgHeartBeat, MsgReset, MsgCheckPower]之一时有意义
    int64_t time;           // 消息时间戳
    int     version;        // 硬件版本号，DevType为DevCard时有意义
} DevMsg;

typedef void(*MsgCallback)(DevMsg msg, void *ctx);

extern "C" {
	DEVSDK_API int ccrfidDevSdkStartWork(MsgCallback fun, void *ctx);
}

# coding=UTF-8
from ctypes import *
import time
import _ctypes

# 定义回调函数参数的结构体
class DevMsg(Structure):
    _fields_ = [("type", c_long),
                ("device", c_long),
                ("cardID", c_long),
                ("readerID", c_long),
                ("locatorID", c_long),
                ("readerRSSI", c_long),
                ("locatorRssiX", c_long),
                ("locatorRssiY", c_long),
                ("isCut", c_char),
                ("isShake", c_char),
                ("isLowpower", c_char),
                ("heartRate", c_long),
                ("power", c_long),
                ("time", c_longlong),
                ("version", c_long)]

注意一下 _fields_的内容：这里就是对 C 数据类型的转换。左边是 C 的结构成员名称，右边则是在 python 中声明一下各个成员的类型。其他的一些类型请参见官方文档。

此外还需要注意一下类似于 c_int, c_void_p 等等的定义是在 ctypes 中的，如果是用import ctypes 的方式包含 ctypes 模块，则应该写成 ctypes.c_long, ctypes.c_longlong,ctypes.c_char。

第三个要注意的是：这个类必须定义为 ctypes.Structure 的子类，否则在进行后续的函数传递时，ctypes 由于不知道如何进行数据类型的对应，会抛出异常

回调函数示例：

# 定义功能类与方法
class DemoDll:

    def __init__(self):
        self.dll = cdll.LoadLibrary('ccrfidDevSDK.dll')
        return

    def ccrfidDevSdkStartWork(self, callback, p):
        return self.dll.ccrfidDevSdkStartWork(callback, p)

# ctypes通过 CFUNCTYPE 支持回调函数，定义返回值与参数，第一个参数表示返回值，void为None
CALLBACK = CFUNCTYPE(None, POINTER(DevMsg))

最后的 CALLBACK通过 ctypes 定义了一个回调函数类型，这个在后面的调用中需要使用

在 CFUNCTYPE 后面的第一个参数为 None，这表示回调函数的返回值类型为 void

完整功能示例:

# coding=UTF-8
from ctypes import *
import time
import _ctypes

# 定义回调函数参数的结构体
class DevMsg(Structure):
    _fields_ = [("type", c_long),
                ("device", c_long),
                ("cardID", c_long),
                ("readerID", c_long),
                ("locatorID", c_long),
                ("readerRSSI", c_long),
                ("locatorRssiX", c_long),
                ("locatorRssiY", c_long),
                ("isCut", c_char),
                ("isShake", c_char),
                ("isLowpower", c_char),
                ("heartRate", c_long),
                ("power", c_long),
                ("time", c_longlong),
                ("version", c_long)]

# 定义功能类与方法
class DemoDll:

    def __init__(self):
        self.dll = cdll.LoadLibrary('ccrfidDevSDK.dll')
        return

    def ccrfidDevSdkStartWork(self, callback, p):
        return self.dll.ccrfidDevSdkStartWork(callback, p)

# ctypes通过 CFUNCTYPE 支持回调函数，定义返回值与参数，第一个参数表示返回值，void为None，第二参数为回调函数的参数为结构体指针
CALLBACK = CFUNCTYPE(None, POINTER(DevMsg))

# 回调函数距离功能实现
def _callback(para):
    # print(dir(para))
    obj = para.__getitem__(0)
    print(obj.type, obj.cardID, obj.readerID, obj.locatorID, obj.heartRate, obj.power, obj.time, obj.version)

# 定义回调函数
callBackFunc = CALLBACK(_callback)

# 实例化功能类
dll = DemoDll()
# 定义一个空的指针
null_ptr = POINTER(c_int)()
# 具体功能调用
c = dll.ccrfidDevSdkStartWork(callBackFunc, null_ptr)

print(c)

time.sleep(100000)

运行结果