/HC_SDK_Dll

海康SDK-python调用

Primary LanguagePython

海康SDK二次开发

一键生成结构体对象

  • convert.py :执行该文件,然后复制海康SDK文档中的结构体声明部分,粘贴过来,然后输入回车即可。 另外还支持一键生成回调函数,一键将java版SDK 结构体定义代码转为 python代码。

开发指导

想要正确调用dll文件,你要找到正确的调用约定,必须查看C头文件或要调用的函数的文档。 整数、字节对象和(unicode)字符串是唯一可以在这些函数调用中直接用作参数的本地Python对象。 它们都不作为C语言NULL指针传递,字节对象和字符串作为指针传递给包含它们的数据的内存块(char或wchar_t)。 Python整数作为平台默认的C int类型传递,它们的值被屏蔽以适合于C类型。在继续使用其他参数类型调用函数之前, 我们必须了解更多关于ctypes数据类型的信息。

Python ctypes 数据类型表

ctypes type C type Python type
c_bool _Bool bool (1)
c_char、CHAR char 1-character bytes object
c_wchar、WCHAR wchar_t 1-character string
c_byte、BYTE、BOOLEAN char int
c_ubyte unsigned char int
c_short short int
c_ushort、WORD、USHORT unsigned short int
c_int、INT int int
c_uint、UINT unsigned int int
c_long、BOOL long int
c_ulong、DWORD unsigned long int
c_longlong __int64 or long long int
c_ulonglong unsigned __int64 or unsigned long long int
c_size_t size_t int
c_ssize_t ssize_t or Py_ssize_t int
c_float、FLOAT float float
c_double、DOUBLE double float
c_longdouble long double float
c_char_p char * (NUL terminated) bytes object or None
c_wchar_p wchar_t * (NUL terminated) string or None
c_void_p、LPVOID void * int or None

开发方法

结构体转换

  • 基本类型转换见上面,嵌套结构体即结构体名.
  • byte * n 数组类型传入 bytes('xxx', 'ascii')
  • 同样地将 ctypes_Array_n 数组转为python字符串也用 bytes(),或者用 cast(strct.name, c_char_p).value强制转为为字符串

参数

  1. 基本类型:转换参照上表
  2. 指针类型: 传入 byref(xxx) ,例如:整形指针 byref(c_int(0))
  3. char* : 传入 bytes(xxx, 'utf-8'))
  4. 缓冲区指针:
    • 开辟:buf = ctypes.create_string_buffer(缓冲大小)
    • 读取: buf.raw 或者 buf.value
  5. LPDWORD
    • 方式一:先创建 a = ctypes.c_ulong(0),再传入 bytef(a),事后打印 a.value
    • 方式二:先创建 a = LPDWORD(ctypes.c_ulong(0)), 直接传入 a,事后打印 a[0]

回调函数

  1. 声明:callback = CFUNCTYPE(返回值类型,参数1类型, 参数2类型,。。。)
  2. 定义 python 实现方法 imp_callback(参数1,参数2,。。。)
  3. 创建回调函数对象:func = CMPFUNC(imp_callback)

错误码

定位到执行SDK失败的函数名,从 《海康设备SDK使用手册.chm》 文件中搜索该函数或者直接搜索NET_DVR_GetLastError,查看相关的错误信息

其他

  • sizeof() 获取C(结构体)对象大小
  • addressof() 取C对象内存地址
  • string_at(addr[, size]) 从地址中取字符数据
  • 👍cast(obj, typ) 强制转换
  • Structure.from_buffer_copy(b'xxxx') 从bytes流中创建结构体
  • cast(obj, POINTER(Structure)) 将一个指针转换为结构体指针