2. JHCreateRelativeInst(创建相对实例句柄)
JHZRESULT JHZAPI JHCreateRelativeInst(
HANDLE * hdl,
unsigned short serverid,
unsigned short gid) ;
参数:
hdl [OUT]实例句柄,指向创建好的实例。
serverid [IN]源地址,发送端标志 ID。
gid [IN]相对地址(屏号) , 高字节为 GROUP ,低字节为 ID ,有效值分别为0x01-0xFE,不能为 0x00 或 0xFF。
返回值:
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
JR_NOT_ENOUGH_CORE 内存不够
功能描述:
上位机和下位机的字库卡通讯协议中包括控制数据包传输的源地址和目的地址(相对地址(屏号)), 本 API 通过指定上位机通讯协议源地址和目的地址来创建一个控 制卡实例 , 从堆中申请一块内存保存控制卡实例信息 , 并将实例的源地址初始化为 serverid, 目的地址初始化为 gid。
注意:此时上位机发送的数据包目的地址为gid, 当 gid为 0xffff 时,此时创建的实例 句柄和用 JHCreateInst()创建的实例句柄相同,任何收到该数据包的控制卡都会处理此数据包,当 用 JHChangeInstRelativeId()修改目的地 址(相 对 地 址(屏 号 ) ) 为0x0101-0xfefe 时,下位机地址和目的地址相同的处理此数据包,下位机地址和目的地址 不相同的不处理此数据包; 当 gid 为 0x0101-0xfefe 时, 下位机地址和目的地址相同的处理此数据包,下位机地址和目的地址不相同的不处理此数据包。