99.JHFingerProg(获取默认节目)
JHZRESULT JHZAPI JHFingerProg(
HANDLE hdl,
unsigned short wid,
unsigned short option,
unsigned short * prev,
unsigned short * ptype,
unsigned long * pstyle,
char * dat,
unsigned short * psize);
参数:
hdl [IN] 实例句柄,与控制卡相对应。
wid [IN] 分区编号,有效值为控制卡中已经创建的分区。
option [IN] 操作方式,格式如下:
位 15-8:节目编号,有效范围 0~63;
位 7-3:保留;
位 2:节目选择,0 表示按位 0 选择, 1 表示永久节目和临时节目;
位 1:优先查询选择, 0 表示不启用, 1 表示启用(位 0 为 0 时,优选查 询临时节目,若临时节目不存在,则查询永久节目;位 0 为 1 时, 优选查询永久节目,若永久节目不存在,则查询临时节目);
位 0:是否永久节目,0 表示临时节目,1 表示永久节目;
prev [OUT]节目标识,用于单分区多节目。
位 15-8:节目编号,有效范围 0~63;
位 7-0:保留, 始终为 0;
ptype [OUT]指向存储节目类型的内存空间, 节目类型包括:
0x0001—文本节目
0x0002—位图节目
0x0003—保留
0x0004—简易数字时钟
0x0005—数字时钟
0x000 保 留
0x0007—倒计时节目
0x0008—正计时节目
0x0009—表格节目
p style [OUT]指向存储节目样式的内存空间, 格式如下:
位 31-4:保留,始终为 0;
位 3:是否按队列加载,仅永久节目有效,为 0 表示立即,为 1 表示按队 列顺序加载;
位 2:加载时是否擦除分区,为 0 表示不擦除, 为 1 表示擦除; 位 1:节目属性, 为 0 表示临时节目, 为 1 表示永久节目;
位 0:保留,始终为 0;
dat [OUT] 指向存储节目内容的内存空间,长度由 psize 指定,该段由 ptype 的值(节目类型)决定,如下所示:
0x0001—文本节目对应 CONTENT:
psize [OUT] 指向存储的节目内容长度的内存空间。
注:参数的具体信息请参考《ZkLED 字库卡 v4.x 使用手册》中“获取分区节目”命令。
返回值:
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
JR_INVALID_OBJECT 无效的对象
功能描述:
获取实例句柄对应控制卡中分区编号为 wid 的分区的节目。