Voip函数新增接口说明与配置文件.doc

Voip函数新增接口说明与配置文件 int WINAPI TvcBoardRegistersip(LPSTR szRegSrvAddr,char* szUsername,char* szPasswd,int nExpires); 参数 szRegSrvAddr LPSTR Sip Sever的IP地址 szUsername char* 注册的用户名 szPasswd char* 注册的密码 nExpires int 注册的有效时间 说明：支持SIP协议的板卡向Sip Server发起注册 返回值为0时，表示调用成功，但不表示注册成功 返回值为-1,时，表示调用失败。 注意： ?????如果对应板卡上有通道处于非 IDLE 状态，则拒绝本操作； ?????如果对应板卡已经注册了，则只能发送更新注册的消息(只能更新nExpires)，即： (1) szRegSrvAddr和szUsername必须跟已经存在注册的szRegSrvAddr和szUsername一样。 (2)认证注册时，szUsername和szPasswd也必须跟已经存在注册的szUsername和szPasswd一样。 (3) nExpires =0，表示取消已经存在的注册。还没有注册的，不能进行取消注册的操作。 (4)取消注册后，Identity 更新为 sip:Username@IPAdress ，还可以使用IP地址进行呼叫。 板卡未注册或已经取消注册，则可向任意Server注册。； ?????如果参数szRegSrvAddr地址填写了一个不存在Server IP，维卡SipStack将会有一个重发超时过程，在超时之前不能继续发送新的注册。 int WINAPI TvcChRegistersip(int nCh,LPSTR szRegSrvAddr, char* szUsername,char* szPasswd,int nExpires); 参数说明： nCh int 通道编号 szRegSrvAddr LPSTR Sip Sever的IP地址 szUsername char* 指定通道注册的用户名 szPasswd char* 指定通道注册的密码 nExpires int 注册的有效时间 说明：SIP通道向Sip Server发起注册 返回值为0时，表示调用成功，但不表示注册成功 返回值为-1,时，表示调用失败。 注意： ?????如果对应板卡上有通道处于非 IDLE 状态，则拒绝本操作； ?????如果对应板卡已经注册了，则只能发送更新注册的消息(只能更新nExpires)，即： (1) szRegSrvAddr和szUsername必须跟已经存在注册的szRegSrvAddr和szUsername一样。 (2)认证注册时，szUsername和szPasswd也必须跟已经存在注册的szUsername和szPasswd一样。 (3) nExpires =0，表示取消已经存在的注册。还没有注册的，不能进行取消注册的操作。 (4)取消注册后，Identity 更新为 sip:Username@IPAdress ，还可以使用IP地址进行呼叫。 板卡未注册或已经取消注册，则可向任意Server注册。； ?????如果参数szRegSrvAddr地址填写了一个不存在Server IP，维卡SipStack将会有一个重发超时过程，在超时之前不能继续发送新的注册。 int WINAPI TvcIpGetSessionCodecType(int nCh); 参数说明： nCh int 通道编号 说明：取得指定IP通道当前通话中实际使用的Codec类型。 返回值 =0,表示返回通话时相应的编码格式。 返回值 -1 表示调用失败。 返回值为1为 A-law。 返回值为2为U-law。 返回值为0x31为GSM 。 int WINAPI TvcSipGetChRegStatus(int nCh, LPSTR pszRegFailInfo); 参数说明： nCh int 通道编号 pszRegFailInfo LPSTR 注册出错时的返回消息 说明：查询SIP通道的注册状态，pszRegFailInfo存放失败信息 返回值-2， 表示调用失败； 返回值-3， 表示已经采用板卡注册模式； 返回值0， 表示注册成功； 返回值 0， 表示注册失败； 返回值-1， 表示未住册。 int WINAPI TvcSipGetBoardRegStatus(LPSTR pszRegFailInfo); 参数说明： pszRegFailInfo LPSTR 注册出错时的返回消息 说明：查询板卡的注册状态, pszRegFailInfo存放失败信息 返回