[it计算机]大华播放sdk开发手册

[it计算机]大华播放sdk开发手册内容摘要：

all 最大区域显示数 define MAX_DISPLAY_WND 4 //同时最多打开 4 个区域显示窗口 显示类型 define DISPLAY_NORMAL 1 //以正常分辨率显示 define DISPLAY_QUARTER 2 //以四分之一分辨率显示 解码缓冲数 define MAX_DIS_FRAMES 50 //最大解码缓冲帧数 define MIN_DIS_FRAMES 6 //最小解码缓冲帧数 大华播放 SDK 编程手册 第 13 页 共 55 页 定位类型 define BY_FRAMENUM 1 //按帧号 define BY_FRAMETIME 2 //按时间 数据流原始缓冲大小 define SOURCE_BUF_MAX 1024*100000 //最大原始缓冲 define SOURCE_BUF_MIN 1024*50 //最小原始缓冲 数据流播放模式 define STREAME_REALTIME 0 //最实时方式 define STREAME_FILE 1 //最流畅方式 解码回调音频帧类型 define T_AUDIO16 101 define T_AUDIO8 100 解码回调视频帧类型 define T_UYVY 1 define T_YV12 3 define T_RGB32 7 媒体信息查询指令 define PLAY_CMD_GetTime 1 define PLAY_CMD_GetFileRate 2 define PLAY_CMD_GetMediaInfo 3 系统功能 define SUPPORT_DDRAW 1 //支持 DIRECTDRAW；如果不支持，则播放器不能工作 define SUPPORT_BLT 2 //显卡支持 BLT 操作；如果不支持，则播放器不能工作 define SUPPORT_BLTFOURCC 4 //显卡 BLT 支持颜色转换 大华播放 SDK 编程手册 第 14 页 共 55 页 define SUPPORT_BLTSHRINKX 8 //显卡 BLT 支持 X 轴缩小 define SUPPORT_BLTSHRINKY 16 //显卡 BLT 支持 Y 轴缩小 define SUPPORT_BLTSTRETCHX 32 //显卡 BLT 支持 X 轴放大 define SUPPORT_BLTSTRETCHY 64 //显卡 BLT 支持 Y 轴放大 define SUPPORT_SSE 128 //CPU 支持 SSE 指令 ,Intel Pentium3 以上支持 SSE 指令 define SUPPORT_MMX 256 //CPU 支持 MMX 指令集 抓图格式类型定义 typedef enum __tPicFormats { PicFormat_BMP = 0, PicFormat_JPEG, } tPicFormats。 媒体信息结构 typedef struct { long lWidth。 long lHeight。 long lFrameRate。 long lChannel。 long lBitPerSample。 long lSamplesPerSec。 }MEDIA_INFO。 帧信息结构 帧 位置 typedef struct{ long nFilePos。 //指定帧在文件中的偏移位置 long nFrameLen。 //帧长度 long nFrameNum。 //帧序号 大华播放 SDK 编程手册 第 15 页 共 55 页 long nFrameTime。 //帧时间 long nErrorFrameNum。 //错误帧号 SYSTEMTIME *pErrorTime。 //错误帧时间 long nErrorLostFrameNum。 //错误帧帧号 long nErrorFrameSize。 //错误帧大小 }FRAME_POS,*PFRAME_POS。 帧信息 typedef struct{ long nWidth。 //画面宽，单位像素。 如果是音频数据则为 0 long nHeight。 //画面高。 如果是音频数据则为 0 long nStamp。 //时标信息，单位毫秒 long nType。 //视频帧 类 型， T_AUDIO16， T_RGB32， T_YV12 long nFrameRate。 //编码时产生的图像帧率 }FRAME_INFO。 帧类型 typedef struct { char *pDataBuf。 //帧数据 long nSize。 //帧大小 long nFrameNum。 //帧序号 BOOL bIsAudio。 //是否音频帧 long nReserved。 //保留字 }FRAME_TYPE。 4 接口定义 通道控制 PLAY_GetFreePort 函数名称 BOOL PLAY_GetFreePort(LONG *plPort) 功能描述 获取空闲的 通道号 ，与 PLAY_RealsePort 成对使用 参数说明 plPort 获取的 通道号 大华播放 SDK 编程手册 第 16 页 共 55 页 返回值 成功返回 TRUE，不成功返回 FALSE PLAY_ReleasePort 函数名称 BOOL PLAY_ReleasePort (LONG lPort) 功能描述 释放端口号 ，与 PLAY_ GetFreePort 成对使用 参数说明 lPort 通道号 返回值 成功返回 TRUE，不成功返回 FALSE 播放文件 PLAY_OpenFile 函数名称 BOOL PLAY_OpenFile(LONG nPort,LPSTR sFileName) 功能描述 打开文件 参数说明 nPort 通道号 sFileName 文件名 , (文件不能超过 4G 或小于 4K) 返回值 成功返回 TRUE，不成功返回 FALSE PLAY_CreateFile 函数名称 BOOL PLAY_CreateFile(LONG nPort,LPSTR sFileName) 功能描述 打开文件 ，自动分配通道号 参数说明 nPort 未使用 sFileName 文件名 , (文件不能超过 4G 或小于 4K) 返回值 成功返回 TRUE，不成功返回 FALSE PLAY_Play 函数名称 BOOL PLAY_Play(LONG nPort, HWND hWnd) 功能描述 开始播放。 如果已经播放，改变当前播放状态为正常速度播放 参数说明 nPort 通道号 hWnd 播放窗口句柄 返回值 成功返回 TRUE，不成功返回 FALSE 大华播放 SDK 编程手册 第 17 页 共 55 页 PLAY_Stop 函数名称 BOOL PLAY_Stop(LONG nPort) 功能描述 结束 播放 参数说明 nPort 通道号 返回值 成功返回 TRUE，不成功返回 FALSE PLAY_CloseFile 函数名称 BOOL PLAY_CloseFile (LONG nPort) 功能描述 关闭播放文件 , 在 PLAY_Stop 后调用 参数说明 nPort 通道号 返回值 成功返回 TRUE，不成功返回 FALSE PLAY_ DestoryFile 函数名称 BOOL PLAY_ DestoryFile (LONG nPort) 功能描述 关闭播放文件，并释放自动分配的通道号。 参数说明 nPort 通道号 返回值 成功返回 TRUE，不成功返回 FALSE 播放流数据 PLAY_OpenStream 函数名称 BOOL PLAY_OpenStream(LONG nPort, PBYTE pFileHeadBuf, DWORD nSize, DWORD nBufPoolSize) 功能描述 打开流接口（类似打开文件） 参数说明 nPort 通道号 pFileHeadBuf 目前不使用，填 NULL nSize 目前不使用，填 0 nBufPoolSize 设置播放器中存放数据流的缓冲区大小。 范围是[SOURCE_BUF_MIN, SOURCE_BUF_MAX]。 一般设为 900*1024， 如果数据送过来相对均匀，可调小该值，如果数据传输不均匀，可增大该值。 返回值 成功返回 TRUE，不成功返回 FALSE 补充说明 pFileHeadBuf 原先用于识别该码流是否是大华码流，后改由码流中的标 大华播放 SDK 编程手册 第 18 页 共 55 页 志来识别，所以现在该参数实际不起作用。 这样做的目的是为方便用户做二次开发，码流识别由播放库内部处理，而不 需要用户传个特定厂家的文件头 PLAY_CreatStream 函数名称 BOOL PLAY_CreatStream(LONG nPort, PBYTE pFileHeadBuf, DWORD nSize, DWORD nBufPoolSize) 功能描述 打开流接口，并自动分配通道号 参数说明 nPort 通道号，未使用 pFileHeadBuf 目前不使用，填 NULL nSize 目前不使用，填 0 nBufPoolSize 置播放器中存放 数据流的缓 冲区大小。 范围是[SOURCE_BUF_MIN, SOURCE_BUF_MAX]。 一般设为 900*1024，如果数据送过来相对均匀，可调小该值，如果数据传输不均匀，可增大该值 返回值 成功返回 TRUE，不成功返回 FALSE PLAY_InputData 函数名称 BOOL PLAY_InputData(LONG nPort, PBYTE pBuf, DWORD nSize) 功能描述 输入从 设备 上得到的流数据；打开流并调用 PLAY_Play 之后才能输入数据。 参数说明 nPort 通道号 pBuf 缓冲区地址 nSize 缓冲区大小 返回值 TURE,表示已经输入数据。 FALSE 表示失败，数据没有输入， 一般为缓冲已满 PLAY_CloseStream 函数名称 BOOL PLAY_CloseStream(LONG nPort) 功能描述 关闭数据流（类似关闭文件） 参数说明 nPort 通道号 返回值 成功返回 TRUE，不成功返回 FALSE 大华播放 SDK 编程手册 第 19 页 共 55 页 PLAY_DestoryStream 函数名称 BOOL PLAY_DestoryStream(LONG nPort) 功能描述 关闭数据流，并 释放自动分配的端口号 参数说明 nPort 通道号 返回值 成功返回 TRUE，不成功返回 FALSE PLAY_OpenStreamEx 函数名称 BOOL PLAY_OpenStreamEx(LONG nPort, PBYTE pFileHeadBuf, DWORD nSize, DWORD nBufP。