设备网络SDK开发使用手册

NET_DVR_GetDeviceAbility

获取设备能力集。

BOOL NET_DVR_GetDeviceAbility(
  LONG     lUserID,
  DWORD    dwAbilityType,
  char     *pInBuf,
  DWORD    dwInLength,
  char     *pOutBuf,
  DWORD    dwOutLength
);

Parameters

lUserID
[in] NET_DVR_Login_V40等登录接口的返回值
dwAbilityType
[in] 能力类型,具体定义见下表:
宏定义 宏定义值 含义
DEVICE_SOFTHARDWARE_ABILITY 0x001 设备软硬件能力
DEVICE_NETWORK_ABILITY 0x002 设备无线网络能力
DEVICE_ENCODE_ALL_ABILITY_V20 0x008 设备所有编码能力
IPC_FRONT_PARAMETER_V20 0x009 设备前端参数
DEVICE_RAID_ABILITY 0x007 设备RAID能力
DEVICE_ALARM_ABILITY 0x00a 设备报警能力
DEVICE_DYNCHAN_ABILITY 0x00b 设备数字通道能力
DEVICE_USER_ABILITY 0x00c 设备用户管理参数能力
DEVICE_NETAPP_ABILITY 0x00d 设备网络应用参数能力
DEVICE_VIDEOPIC_ABILITY 0x00e 设备图像参数能力
DEVICE_JPEG_CAP_ABILITY 0x00f 设备JPEG抓图能力
DEVICE_SERIAL_ABILITY 0x010 设备RS232和RS485串口能力
DEVICE_ABILITY_INFO 0x011 设备通用能力类型,具体能力根据发送的能力节点来区分
STREAM_ABILITY 0x012 设备流能力集
MATRIXDECODER_ABILITY 0x200 多路解码器显示、解码能力
DECODER_ABILITY 0x261 解码器XML能力集
SNAPCAMERA_ABILITY 0x300 智能交通摄像机能力集
PIC_CAPTURE_ABILITY 0x402 抓图图片分辨率能力集
pInBuf
[in] 输入缓冲区指针(按照设备规定的能力参数的描述方式组合,可以是XML文本或结构体形式,详见“Remarks”说明)
dwInLength
[in] 输入缓冲区的长度
pOutBuf
[out] 输出缓冲区指针(按照设备规定的能力集的描述方式,可以是XML文本或结构体形式,详见“Remarks”说明)
dwOutLength
[in] 接收数据的缓冲区的长度

Return Values

TRUE表示成功,FALSE表示失败。接口返回失败请调用NET_DVR_GetLastError获取错误码,通过错误码判断出错原因。

Remarks

接口中pInBuf参数的具体定义格式按照不同的设备规定有所不同,可以是以结构体的形式或者XML描述方式。同样地,参数pOutBuf的输出表达格式也按不同的设备规定可以是以结构体的形式或者XML描述方式。下表列出了能力获取时,需要输入参数和输出参数的格式定义。

能力类型宏定义 能力类型说明 pInBuf pOutBuf
DEVICE_SOFTHARDWARE_ABILITY 获取设备软硬件能力 设备软硬件能力XML描述(BasicCapability)
DEVICE_NETWORK_ABILITY 获取无线设备网络能力 设备无线网络能力XML描述(NetworkSetting)
DEVICE_ENCODE_ALL_ABILITY_V20 获取设备所有编码能力 编码能力获取输入描述 设备所有编码能力XML描述(AudioVideoCompressInfo)
IPC_FRONT_PARAMETER_V20 获取设备前端参数 前端参数能力获取输入描述 设备前端参数XML描述(CAMERAPARA)
DEVICE_RAID_ABILITY 获取设备RAID能力 设备RAID能力XML描述(RAID)
DEVICE_ALARM_ABILITY 获取设备报警能力 报警能力获取输入描述 设备报警能力XML描述(AlarmAbility)
DEVICE_DYNCHAN_ABILITY 获取设备数字通道能力 数字通道能力获取输入描述 设备数字通道能力XML描述(DynChannelAbility)
DEVICE_USER_ABILITY 获取设备用户管理参数能力 用户管理参数能力获取输入描述 设备用户管理参数能力XML描述(UserAbility)
DEVICE_NETAPP_ABILITY 获取设备网络应用参数能力 网络应用参数能力获取输入描述 设备网络应用参数能力XML描述(NetAppAbility)
DEVICE_VIDEOPIC_ABILITY 获取设备图像参数能力 图像参数能力获取输入描述 设备图像参数能力XML描述(VideoPicAbility)
DEVICE_JPEG_CAP_ABILITY 获取设备JPEG抓图能力 JPEG抓图能力获取输入描述 设备JPEG抓图能力XML描述(JpegCaptureAbility)
DEVICE_SERIAL_ABILITY 获取设备RS232和RS485串口能力 串口能力获取输入描述 设备串口能力XML描述(SerialAbility)
DEVICE_ABILITY_INFO 设备通用能力类型,具体能力根据发送的能力节点来区分 获取PTZ能力集 PTZ能力XML描述(PTZAbility)
获取报警事件处理能力集 报警事件处理能力XML描述(EventAbility)
获取ROI能力集 ROI能力XML描述(ROIAbility)
获取录像相关能力集 录像相关能力XML描述(RecordAbility)
NVR前端待接入设备通道能力集 NVR前端待接入设备通道能力XML描述(GetAccessDeviceChannelAbility)
获取设备本地预览切换能力集 设备本地预览切换能力XML描述(PreviewSwitchAbility)
获取设备N+1能力集 设备N+1能力XML描述(NPlusOneAbility)
获取设备磁盘相关能力集 设备磁盘相关能力XML描述(HardDiskAbility)
获取IPC配置文件导入导出能力集 IPC配置文件导入导出能力XML描述(IPAccessConfigFileAbility)
获取设备通道输入能力集 设备通道输入能力XML描述(ChannelInputAbility)
获取前端参数动态能力集 设备前端参数动态能力XML描述(CameraParaDynamicAbility)
获取报警触发录像能力集 设备报警触发录像能力XML描述(AlarmTriggerRecordAbility)
获取GB/T28181能力集 设备GB/T28181能力XML描述(GBT28181AccessAbility)
获取IO口输入输出能力集 设备IO口输入输出能力XML描述(IOAbility)
获取协议接入能力集 设备协议接入能力XML描述(AccessProtocolAbility)
获取安全认证配置能力集 安全认证配置能力XML描述(SecurityAbility)
获取摄像机架设参数能力集 摄像机架设参数能力XML描述(CameraMountAbility)
获取日志搜索能力集 日志搜索能力XML描述(SearchLogAbility)
获取CVR设备能力集 CVR设备能力XML描述(CVRAbility)
获取图像显示参数能力集 图像显示参数能力XML描述(ImageDisplayParamAbility)
设备智能相关能力集 获取智能设备能力集 智能设备能力XML描述(VcaDevAbility)
获取智能通道控制能力集 智能通道控制能力XML描述(VcaCtrlAbility)
获取智能通道分析能力集 智能通道分析能力XML描述(VcaChanAbility)
获取双目能力集 双目能力XML描述(BinocularAbility)
STREAM_ABILITY 获取设备流能力 获取流能力集 流能力XML描述(StreamAbility)
MATRIXDECODER_ABILITY 获取多路解码器显示、解码能力 NET_DVR_MATRIX_ABILITY
DECODER_ABILITY 获取解码器XML能力集 解码器能力集获取输入描述 解码器能力集XML描述
SNAPCAMERA_ABILITY 获取智能交通摄像机的能力 NET_DVR_SNAP_ABILITY
PIC_CAPTURE_ABILITY 获取图片能力 通道号(4个字节) NET_DVR_COMPRESSIONCFG_ABILITY
  • 设备能力集中所有编码能力和前端参数能力集在4.2版本的SDK中已经做了扩展,扩展前V1.0版本的能力集请参见NET_DVR_GetDeviceAbility
  • 在调用该接口获取设备能力集之前可以先调用NET_DVR_SetSDKLocalCfg启用模拟能力集,同时加载LocalXml.zip(要求和网络通讯库放在同一个目录下)。
  • See Also

    NET_DVR_Login   NET_DVR_Login_V30