toupcamsdk错误码说明?
toupcamsdk返回错误码的方式有两种:一是通过api函数的直接返回值;二是通过EVENT事件告知上位机。
其中方法一是主要方案,方法二是方法一的一个补充。
- 通过api函数的直接返回值HRESULT
toupcamsdk中除了少数几个没有返回值外,其他api的返回值均为HRESULT,采用的是windows标准错误码。以下是toupcamsdk用到的错误码:
错误码 |
宏定义 |
含义 |
0x00000000 |
S_OK |
操作成功完成 |
0x00000001 |
S_FALSE |
操作失败 |
0x8000ffff |
E_UNEXPECTED |
灾难性故障 |
0x80004001 |
E_NOTIMPL |
尚未实现 |
0x80004002 |
E_NOINTERFACE |
不支持此接口 |
0x80070005 |
E_ACCESSDENIED |
拒绝访问 |
0x8007000e |
E_OUTOFMEMORY |
内存资源不足,无法完成此操作 |
0x80070057 |
E_INVALIDARG |
参数错误 |
0x80004003 |
E_POINTER |
无效指针 |
0x80004005 |
E_FAIL |
未指定的错误 |
0x8001010e |
E_WRONG_THREAD |
应用程序调用一个已为另一线程整理的接口 |
0x8007001f |
E_GEN_FAILURE |
连到系统上的设备没有发挥作用 |
0x800700aa |
E_BUSY |
请求的资源在使用中 |
0x8000000a |
E_PENDING |
完成该操作所需的数据还不可使用 |
0x8001011f |
E_TIMEOUT |
由于超时时间已过,该操作返回 |
其他 |
|
未知错误 |
根据函数api的名称和其返回值,可以判断出了什么问题,比如Toupcam_put_Size返回0x80070057错误,说明设置分辨率时,输入的参数有错误。
- 通过EVENT事件
主要就以下四个事件(通过Toupcam_StartPullModeWithWndMsg中的消息或Toupcam_StartPullModeWithCallback中的回调函数或Toupcam_StartPushMode (V3、V4)中的回调函数传递):
错误码 |
宏定义 |
含义 |
0x0080 |
TOUPCAM_EVENT_ERROR |
未知错误 |
0x0081 |
TOUPCAM_EVENT_DISCONNECTED |
相机断开连接 |
0x0082 |
TOUPCAM_EVENT_NOFRAMETIMEOUT |
没有数据帧上来 |
0x0085 |
TOUPCAM_EVENT_NOPACKETTIMEOUT |
没有数据包上来 |