设备网络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] 能力类型,具体定义见下表:
宏定义 宏定义值 含义
ACS_ABILITY 0x801 门禁能力集
ALARMHOST_ABILITY 0x500 报警主机设备能力集
DEVICE_ABILITY_INFO 0x011 设备通用能力类型,具体能力根据发送的能力节点来区分
pInBuf
[in] 输入缓冲区指针(按照设备规定的能力参数的描述方式组合,可以是XML文本或结构体形式)
dwInLength
[in] 输入缓冲区的长度
pOutBuf
[out] 输出缓冲区指针(按照设备规定的能力集的描述方式,可以是XML文本或结构体形式)
dwOutLength
[in] 接收数据的缓冲区的长度

Return Values

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

Remarks

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

获取报警主机XML能力集
能力类型宏定义 能力类型说明 pInBuf pOutBuf
ACS_ABILITY 获取门禁能力集 门禁能力集获取输入描述 门禁能力集XML描述(AcsAbility)
ALARMHOST_ABILITY 获取报警主机能力集 NET_DVR_ALARMHOST_ABILITY
DEVICE_ABILITY_INFO 设备通用能力类型,具体能力根据发送的能力节点来区分获取协议接入能力集 设备协议接入能力XML描述(AccessProtocolAbility)
报警主机XML能力集获取输入描述 报警主机能力集XML描述(AlarmHostAbility)

See Also

NET_DVR_Login_V40