设备网络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] 能力类型,具体定义见下表:
宏定义 宏定义值 含义
STREAM_ABILITY 0x012 设备流能力集
IP_VIEW_DEV_ABILITY 0x014 IP可视对讲主机能力集
ACS_ABILITY 0x801 门禁能力集
pInBuf
[in] 输入缓冲区指针(按照设备规定的能力参数的描述方式组合,可以是XML文本或结构体形式)
dwInLength
[in] 输入缓冲区的长度
pOutBuf
[out] 输出缓冲区指针(按照设备规定的能力集的描述方式,可以是XML文本或结构体形式)
dwOutLength
[in] 接收数据的缓冲区的长度

Return Values

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

Remarks

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

能力类型宏定义 能力类型说明 pInBuf pOutBuf
STREAM_ABILITY 获取设备流能力 获取流能力集 流能力XML描述(StreamAbility)
IP_VIEW_DEV_ABILITY 获取IP可视对讲主机能力 IP可视对讲主机能力XML描述(IpViewDevAbility)
ACS_ABILITY 获取门禁能力集 门禁能力集获取输入描述 门禁能力集XML描述(AcsAbility)

See Also

NET_DVR_Login_V30