金鹏DVR网络SDK编程手册.docVIP

金鹏DVR网络SDK编程手册 （版本1.0，2005-8-18） 版本说明： (2.0版本) 修改了以下的函数： int __stdcall JPR_DataSearch_PlayFile(OperateDay *pOperateDay,ChannelFileInfo *pCfi,int nChannel,HWND hWnd),具体请参考函数说明； int __stdcall JPR_DataSearch_StopPlayFile(int HandleStock)，具体请参考函数说明； int __stdcall JPR_DownFile_Start(OperateDay *pOperateDay,ChannelFileInfo *pCfi,int nChannel,LPCTSTR lpszTargetPath)，具体请参考函数说明； int __stdcall JPR_DownFile_Stop(int HandleStock)，具体请参考函数说明。 另外还增加了函数int __stdcall JPR_PlayerGetChannel()，用以为本地播放获得当前可用的通道号，具体请参考函数说明。 (1.0版本) SDK推出的第一个版本。根据二次开发商的要求和意见陆续推出新版本，力求解决可能存在的一些隐患问题。 说明 本SDK的网络控制只针对于金鹏的E-8020C和E-8020CS的机型。 目前该SDK支持64路解码，回放所支持的最大路数与机器的配置有关，但不大于64路（根据我们自己的测试，在Pentium4 2.0下可支持9--12路的实时播放，今后效率会继续提高），建议用户的机器CPU配置在Pentium4 C1.7G以上。 在本SDK中，有两种画质可供选择：普通画质和高画质。选用高画质时图象质量明显变好（特别是在低码率时），但需占用较多的CPU资源，建议在多画面时选用普通画质，在放大时选用高画质。 本SDK使用offscreen模式来显示图象，若显卡不支持硬件的Blt缩放，将加重CPU的负担。 本SDK支持24位色和32位色的图象显示。 针对DVR主机拥有中文和英文的两种版本，如果选择了T014版本的话用户信息API和UDP连接API将不可用本SDK提供中文和英文两套语言。 本SDK暂时只支持VC＋＋开发语言。 错误码定义： 本SDK的API调用，成功一般返回(true)，失败返回(false)。对于很多函数将会有一些特定的值返回给调用者，值的意义在函数说明里会有详细的说明。对于播放文件的API调用，都有详细的错误原因，当函数返回FALSE的时候，可进一步使用GetLastError（）函数得到具体错误，错误号详见下表： 错误号 说明 PLAYER_INIT_DIRECTDRAW_FAILED 初始化directdraw对象失败 PLAYER_INIT_PRIMARY_SURFACE_FAILED 初始化directdraw主表面失败 PLAYER_INIT_OFFSCREEN_SURFACE_FAILED 初始化directdraw离屏表面失败，可能是显卡不支持 PLAYER_CAN_NOT_OPEN_FILE 无法打开指定文件 PLAYER_FILE_HAS_NO_VALID_INFORMATION 文件不包含有效信息 PLAYER_CREATE_BUFFER_FAILED 创建缓冲区失败 PLAYER_INIT_VIDEO_DECODER_FAILED 初始化视频解码器失败 PLAYER_UNSUPPORTED_COLOR_DEPTH 不支持的系统色深 PLAYER_INVALID_DIRECTDRAW_SURFACE 无效的directdraw表面，可能是初始化directdraw表面时没有成功 PLAYER_PARAMETER_OUT_OF_RANGE 参数不在范围内 PLAYER_STREAM_IS_NOT_OPENED 流没有打开 PLAYER_STREAM_IS_NOT_PLAYED 流没有开始播放 PLAYER_FILE_IS_NOT_OPENED 文件没有打开 PLAYER_INIT_AUDIO_DECODER_FAILED 初始化音频解码器失败 PLAYER_UNSUPPORT_CURRENT_PLAY_MODE 该函数不支持当前的播放模式，比如现在在播放流，则Player_GetFileFrames（）函数无效。 PLAYER_STREAM_IS_NOT_CLOSED 流没有关闭 PLAYER_FILE_IS_NOT_CLOSED 文件没有关闭 PLAYER_UNSUPPORT_CURRENT_STATUS 该函数不支持当前的状态，比如现在处于停止的状态，则Player_Pau