设备网络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_USER_ABILITY 0x00c 设备用户管理参数能力
DEVICE_NETAPP_ABILITY 0x00d 设备网络应用参数能力
DEVICE_SERIAL_ABILITY 0x010 设备RS232和RS485串口能力
DEVICE_ABILITY_INFO 0x011 设备通用能力类型，具体能力根据发送的能力节点来区分
ALARMHOST_ABILITY 0x500 报警主机设备能力集
pInBuf
[in] 输入缓冲区指针（按照设备规定的能力参数的描述方式组合，可以是XML文本或结构体形式）
dwInLength
[in] 输入缓冲区的长度
pOutBuf
[out] 输出缓冲区指针（按照设备规定的能力集的描述方式，可以是XML文本或结构体形式）
dwOutLength
[in] 接收数据的缓冲区的长度

Return Values

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

Remarks

接口中pInBuf参数的具体定义格式按照不同的设备规定有所不同，可以是以结构体的形式或者XML描述方式。同样地，参数pOutBuf的输出表达格式也按不同的设备规定可以是以结构体的形式或者XML描述方式。前6种能力描述都是以XML格式给出，详见各产品的能力描述解析方法，这里不进行详细说明。下表列出了其余能力类型获取时，需要输入参数和输出参数的格式定义。

能力类型宏定义 能力类型说明 pInBuf pOutBuf
DEVICE_SOFTHARDWARE_ABILITY 获取设备软硬件能力 无 设备软硬件能力XML描述
DEVICE_USER_ABILITY 获取设备用户管理参数能力 用户管理参数能力获取输入描述 设备用户管理参数能力XML描述
DEVICE_NETAPP_ABILITY 获取设备网络应用参数能力 网络应用参数能力获取输入描述 设备网络应用参数能力XML描述
DEVICE_SERIAL_ABILITY 获取设备RS232和RS485串口能力 串口能力获取输入描述 设备串口能力XML描述
DEVICE_ABILITY_INFO 获取报警主机XML能力集 报警主机XML能力集获取输入描述 报警主机能力集XML描述(AlarmHostAbility)
ALARMHOST_ABILITY 获取报警主机设备能力集 无 NET_DVR_ALARMHOST_ABILITY

Remarks

1. wExpandAlarmInNum大于0表示支持防区编号功能，此时NET_DVR_ALARMIN_PARAM中的byJointSubSystem，byModuleStatus，wModuleAddress，byModuleChan，byModuleType，wZoneIndex有效。支持“获取子系统内防区”，“自动搜索”，“自动注册”功能。

2. wExpandAlarmOutNum大于0表示支持触发器编号功能，此时NET_DVR_ALARMOUT_PARAM中的wTriggerIndex，byModuleType，byModuleStatus，wModuleAddress，byModuleChan字段有效。支持“获取所有触发器”，“自动搜索”，“自动注册”功能。

See Also

NET_DVR_Login   NET_DVR_Login_V30