HC_SDK_Dll
HC_SDK_Dll copied to clipboard
Published
20 hours ago •
wanZzz6
wanZzz6
海康SDK-python调用指南
海康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强制转为为字符串
参数
- 基本类型：转换参照上表
- 指针类型： 传入
byref(xxx)，例如：整形指针 byref(c_int(0)) - char* : 传入
bytes(xxx, 'utf-8')) - 缓冲区指针：
- 开辟：
buf = ctypes.create_string_buffer(缓冲大小) - 读取:
buf.raw或者buf.value
- 开辟：
-
LPDWORD- 方式一：先创建
a = ctypes.c_ulong(0)，再传入bytef(a)，事后打印a.value - 方式二：先创建
a = LPDWORD(ctypes.c_ulong(0))， 直接传入a，事后打印a[0]
- 方式一：先创建
回调函数
- 声明：
callback = CFUNCTYPE（返回值类型，参数1类型， 参数2类型，。。。） - 定义 python 实现方法
imp_callback(参数1，参数2，。。。) - 创建回调函数对象：
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))将一个指针转换为结构体指针
wanZzz6