RV100系列嵌入式DVR网络客户端软件开发包-Read.doc

DVR客户端SDK 说明书  PAGE 16 RV100系列嵌入式DVR 网络客户端软件开发包(SDK) 版本 1.0 说明书 2003-9-4 草案 nodman ?2003 深傲科技 文件列表及说明： 文件功能Src/net/net.hSDK接口声明Src/net/net_opt.h参数设置结构Src/notif/notif_cmd.h网络命令通知Src/notif/notif_av.h视频数据通知Src/notif/notif_opt.h参数设置通知Src/notif/notif_bk.h数据备份通知DvrClt.dllSDK主模块DLLDvrClt.libSDK库文件 使用对象： 本SDK用Microsoft Visual C++ 6.0?编写。本说明中所有的例子以及随SDK的示例程序都是针对Microsoft Visual C++ 6.0?而言的，并且示例是使用MFC?库编写的。 对于其他语言环境本SDK没有经过测试，后果自负。 本SDK中接口用到的参数: ip是网络字节顺序 (network byte order, big endian) port是主机顺序 (host byte order, little endian) 比如: 192.168.0.1:8101 对于本SDK的期望值为: ip = inet_addr(192.168.0.1) = (0x0100a8c0); port = 8101 IPPORT_TYPE：很多API中用到ULONG ip, USHORT port这样的参数，为了方便，定义了这样的宏：#define IPPORT_TYPE ULONG ip, USHORT port；IPPORT_TYPE其实是2个参数！ XXXX_CALLEE：通知(Notification)接收者，在本SDK中均为HWND类型。一般这是指一个Win32窗口对象。 名词解释： 实时视频：主机端发来的现场视频 点播视频：主机端以前录制的视频档案，可供客户端查阅 通知接收者(CALLEE)：某些操作需要主机端的确认，提供CALLEE以便主机端回复时，客户端软件可以得到通知。 通道（channel）：主机端的视频通道 组别（group）：客户端的视频窗口序号。以0为起点 (0~9)。在客户端软件的视频窗口中打开主机视频通道时，通道和组别序号可以一一对应，也可以不同。 数据类型： IPPORT_TYPE： 主机端网络地址，IP和端口的宏定义。 #define IPPORT_TYPE ULONG ip, USHORT port NET_HANDLE： 网络句柄。客户端软件与SDK的纽带。参见net_create() 接口函数。 NET_OPTIONS： 参数设置类型。 CMD_CALLEE，VIDEO_CALLEE，BACKUP_CALLEE：各种功能的通知被通知者。在这里OPT_GET_CALLEE, OPT_SET_CALLEE：参数设置通知接收者。请参见notif_opt.h。他们的类型其实都是HWND―Win32窗口句柄。通知的方式是Win32窗口消息传递(SendMessage或PostMessage)。具体消息请参见功能对应的头文件(notif_*.h) VOD_GROUP：视频点播通道。这是一个特殊的通道，客户端软件在任何时刻只能点播一路视频，叠加点播操作会覆盖先前打开的点播视频。 VOD_SPEED：视频点播播放方式，包括正常播放、快进、快退、帧进等。 宏 MAKEDWORD(hi,lo)：将两个short型数据合并为一个DWORD类型，hi为其高16位，lo位其低16位。 宏 HSHORT(dw)：从DWORD型dw中解出高16位short型数 宏 LSHORT(dw)：从DWORD型dw中解出低16位short型数 SDK各项接口接口说明： /// 网络句柄. #define NET_HANDLE LONG net_create 原型：NET_HANDLE net_create(ULONG ip, USHORT port,  CMD_CALLEE cb,  ULONG Mpeg4,  BOOL jump_frame,  BOOL network_type) 功能：该函数是SDK的入口，负责初始化SDK以及网络功能。 参数： ip： 本地IP地址。一般指定0，表示默认。 port： 本地网络端口。范围4096-65535，一般指定8101。 cb：网络消息回调。当主机有消息发来时，cb可以得到消息。他们的类型其