新添加SV4000E视频卡。
This commit is contained in:
TAO Cheng
@@ -0,0 +1,524 @@
|
||||
|
||||
#ifndef __DXMEDIACAP_2011__
|
||||
#define __DXMEDIACAP_2011__
|
||||
|
||||
#include "datastru.h"
|
||||
|
||||
/*
|
||||
描述：
|
||||
初始化 SDK ，必须在调用其他函数之前调用
|
||||
参数：
|
||||
无
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXInitialize();
|
||||
void __stdcall DXUninitialize();
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取初始化成功的设备总数
|
||||
参数：
|
||||
无
|
||||
返回值：
|
||||
匹配的设备总数
|
||||
// */
|
||||
unsigned __stdcall DXGetDeviceCount();
|
||||
|
||||
/*
|
||||
描述：
|
||||
枚举音视频编码过滤器
|
||||
参数：
|
||||
devTags - [out] 用于返回获得的过滤器的 TAG 的数组
|
||||
num - [in/out] 指定 devTags 数组的元素个数，返回时则是实际上获得的过滤器的 TAG 的个数
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXEnumVideoCodecs(PDEVICE_TAG devTags, unsigned& num);
|
||||
unsigned __stdcall DXEnumAudioCodecs(PDEVICE_TAG devTags, unsigned& num);
|
||||
|
||||
/*
|
||||
描述：
|
||||
枚举视频捕捉设备过滤器
|
||||
参数：
|
||||
devTags - [out] 用于返回获得的过滤器的 TAG 的数组
|
||||
num - [in/out] 指定 devTags 数组的元素个数，返回时则是实际上获得的过滤器的 TAG 的个数
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXEnumVideoDevices(PDEVICE_TAG devTags, unsigned& num);
|
||||
|
||||
/*
|
||||
描述：
|
||||
枚举音频捕捉和渲染设备过滤器
|
||||
参数：
|
||||
devTags - [out] 用于返回获得的过滤器的 TAG 的数组
|
||||
num - [in/out] 指定 devTags 数组的元素个数，返回时则是实际上获得的过滤器的 TAG 的个数
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXEnumAudioDevices(PDEVICE_TAG devTags, unsigned& num);
|
||||
unsigned __stdcall DXEnumSoundDevices(PDEVICE_TAG devTags, unsigned& num);
|
||||
|
||||
/*
|
||||
描述：
|
||||
占用采集设备
|
||||
参数：
|
||||
idx - [in] 设备在枚举过程中的序号
|
||||
err - [out] 返回错误代码
|
||||
返回值：
|
||||
成功则返回设备句柄，否则返回 NULL。可通过 err 获得错误代码
|
||||
// */
|
||||
device_handle __stdcall DXOpenDevice(unsigned idx, unsigned* err = NULL);
|
||||
void __stdcall DXCloseDevice(device_handle device);
|
||||
|
||||
/*
|
||||
描述：
|
||||
将属性页显示在制定窗体的指定区域
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
attrID - [in] 属性类别
|
||||
hOwner - [in] 父窗体的句柄。NULL - 隐藏属性页
|
||||
rect - [in] 在父窗体上显示的区域。NULL - 表示父窗体的整个客户区
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXShowDeviceAttr(device_handle device, unsigned attrID, HWND hOwner, RECT* rect);
|
||||
|
||||
// unsigned __stdcall DXShowDeviceAttr(device_handle device, HWND XBar, HWND Capture, HWND stream, HWND codec);
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取视频属性
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
standard - [out] 视频制式
|
||||
colorspace - [out] 色彩空间
|
||||
width - [out] 视频宽度（单位：像素）
|
||||
height - [out] 视频高度（单位：像素）
|
||||
framerate - [out] 视频帧率（单位：帧/秒）
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXGetVideoPara(device_handle device, unsigned& standard, unsigned& colorspace,
|
||||
unsigned& width, unsigned& height, float& framerate);
|
||||
|
||||
/*
|
||||
描述：
|
||||
设置视频属性
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
standard - [in] 视频制式
|
||||
colorspace - [in] 色彩空间
|
||||
width - [in] 视频宽度（单位：像素）
|
||||
height - [in] 视频高度（单位：像素）
|
||||
framerate - [in] 视频帧率（单位：帧/秒）
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetVideoPara(device_handle device, unsigned standard, unsigned colorspace,
|
||||
unsigned width, unsigned height, float framerate);
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取显示属性的取值范围、默认值、步长、标志
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
paraType - [in] 参数类型
|
||||
0 - 亮度，1 - 对比度，2 - 饱和度，3 - 色度，4 - 锐度
|
||||
pMin - [in] 最小值
|
||||
pMax - [in] 最大值
|
||||
pSteppingDelta - [in] 步长
|
||||
pDefault - [in] 默认值
|
||||
pCapsFlags - [in] 自动/手动标志
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXGetDisplayParaRange(device_handle device, unsigned paraType,
|
||||
long* pMin, long* pMax, long* pSteppingDelta, long* pDefault, long* pCapsFlags);
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取显示属性
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
paraType - [in] 参数类型
|
||||
0 - 亮度，1 - 对比度，2 - 饱和度，3 - 色度，4 - 锐度
|
||||
value - [out] 参数值
|
||||
flag - [out] 自动/手动标志
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXGetDisplayPara(device_handle device, unsigned paraType, long& value, long& flags);
|
||||
|
||||
/*
|
||||
描述：
|
||||
设置显示属性
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
paraType - [in] 参数类型
|
||||
0 - 亮度，1 - 对比度，2 - 饱和度，3 - 色度，4 - 锐度
|
||||
value - [in] 参数值
|
||||
flag - [in] 自动/手动标志
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetDisplayPara(device_handle device, unsigned paraType, long value, long flags);
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取视频编码器属性
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
mode - [out] 编码模式
|
||||
bitrate - [out] 码率（单位：kbps）
|
||||
keyinterval - [out] 关键帧间隔
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXGetVideoCodecPara(device_handle device, unsigned& mode, unsigned& bitrate, unsigned& keyinterval);
|
||||
|
||||
/*
|
||||
描述：
|
||||
设置视频编码器属性
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
mode - [in] 编码模式
|
||||
bitrate - [in] 码率（单位：kbps）
|
||||
keyinterval - [in] 关键帧间隔
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetVideoCodecPara(device_handle device, unsigned mode, unsigned bitrate, unsigned keyinterval);
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取设备当前选择的端子和包含的输入端子
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
curSource - [out] 当前选择的输入端子的序号。NULL - 忽略
|
||||
sources - [out] 包含的输入端子的类型数组（比如：S-VIDEO、DV...）。NULL - 忽略
|
||||
num - [in/out] 端子数量。NULL - 忽略，此时尽可获取当前选择的输入端子
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXGetVideoSources(device_handle device, unsigned* curSource, unsigned* sources = NULL, unsigned char* num = NULL);
|
||||
|
||||
/*
|
||||
描述：
|
||||
设置设备的输入端子
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
source - [in] 当前选择的输入端子的序号
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetVideoSource(device_handle device, unsigned source);
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取设备的信号状态
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
signal - [out] 信号状态。0 - 信号丢失；1 - 信号正常
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXGetSignalPresent(device_handle device, unsigned& signal);
|
||||
|
||||
/*
|
||||
描述：
|
||||
控制设备运行状态
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXDeviceRun(device_handle device);
|
||||
unsigned __stdcall DXDevicePause(device_handle device);
|
||||
unsigned __stdcall DXDeviceStop(device_handle device);
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取设备运行状态
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
state - [out] 设备运行状态
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXGetDeviceState(device_handle device, unsigned& state);
|
||||
|
||||
/*
|
||||
描述：
|
||||
将视频显示在指定窗体的矩形区域内
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
hWnd - [in] 显示视频的窗体句柄。NULL - 停止显示视频
|
||||
rect - [in] 视频显示的矩形区域。NULL - 占用整个窗体
|
||||
vmrtype - [in] 该保留参数。（准备做指定显示过滤器只用）
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXStartPreview(device_handle device, HWND hWnd, PRECT rect, unsigned vmrtype);
|
||||
|
||||
/*
|
||||
描述：
|
||||
停止预览
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXStopPreview(device_handle device);
|
||||
|
||||
/*
|
||||
描述：
|
||||
冻结视频显示部分
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
bFreeze - [in] TRUE - 冻结显示，FALSE - 解冻显示
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXFreezePreview(device_handle device, BOOL bFreeze);
|
||||
|
||||
/*
|
||||
描述：
|
||||
检查设备是否包含音频
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
bHasAudio - [out] TRUE - 包含音频，FALSE - 没有音频
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXHasAudio(device_handle device, BOOL& bHasAudio);
|
||||
|
||||
/*
|
||||
描述：
|
||||
为设备分配音频采集设备。
|
||||
注意：!!! 只能在 state_stopped 状态下调用
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
bSound - [in] TRUE - 开始声音输出，FALSE - 终止声音输出
|
||||
audioDevice - [in] 音频采集设备。NULL - 使用设备自带的音频
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetAudioDevice(device_handle device, PDEVICE_TAG audioDevice = NULL);
|
||||
|
||||
/*
|
||||
描述：
|
||||
开始或者终止声音输出。
|
||||
注意：!!! 只有开始了声音输出，静音操作、音量调节、录像时包含音频等操作才能成功
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
bSound - [in] TRUE - 开始声音输出，FALSE - 终止声音输出
|
||||
soundDevice - [in] 声音输出设备。NULL - 使用默认设备
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetSoundOut(device_handle device, BOOL bSound/*, PDEVICE_TAG soundDevice = NULL*/);
|
||||
|
||||
/*
|
||||
描述：
|
||||
静音操作
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
bMute - [in] TRUE - 静音，FALSE - 非静音
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码，一般失败原因是因为没有开始声音输出
|
||||
// */
|
||||
unsigned __stdcall DXEnableMute(device_handle device, BOOL bMute);
|
||||
|
||||
/*
|
||||
描述：
|
||||
设置音量和平衡
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
volume - [in] 音量大小，取值范围(0, 100]
|
||||
balance - [in] 左右平衡，取值范围[-10, 10]，负数表示左声道强，正数表述右声道强，0 - 左右平衡
|
||||
注意：!!! NULL - 表示不设置平衡
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码，一般失败原因是因为没有开始声音输出
|
||||
// */
|
||||
unsigned __stdcall DXSetAudioVolume(device_handle device, unsigned char volume, unsigned char* const balance = NULL);
|
||||
|
||||
/*
|
||||
描述：
|
||||
获取音量和平衡
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
volume - [out] 音量大小，取值范围(0, 100]
|
||||
注意：!!! NULL - 表示不获取音量
|
||||
balance - [out] 左右平衡，取值范围[-10, 10]，负数表示左声道强，正数表述右声道强，0 - 左右平衡
|
||||
注意：!!! NULL - 表示不获取平衡
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码，一般失败原因是因为没有开始声音输出
|
||||
// */
|
||||
unsigned __stdcall DXGetAudioVolume(device_handle device, unsigned char* volume, unsigned char* balance = NULL);
|
||||
|
||||
/*
|
||||
描述：
|
||||
更换视频编码器
|
||||
注意：!!! 当正在进行录像时，则操作失败
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
videoEncoder - [in] 视频编码器的 TAG，NULL - 表示不用编码，即录像时采用原始数据
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetVideoCodec(device_handle device, PDEVICE_TAG videoEncoder);
|
||||
|
||||
/*
|
||||
描述：
|
||||
更换音频编码器
|
||||
注意：!!! 当正在进行录像时，则操作失败
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
audioEncoder - [in] 音频编码器的 TAG，NULL - 表示不用编码，即录像时采用原始数据
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetAudioCodec(device_handle device, PDEVICE_TAG audioEncoder);
|
||||
|
||||
/*
|
||||
描述：
|
||||
开始录像
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
szFileName - [in] 指定录像文件全路径。NULL - 停止录像
|
||||
saveAudio - [in] 是否将音频也录制到文件中
|
||||
timeSize - [in] 限定录像文件的时间长度（单位：秒），NULL - 不限制
|
||||
dataSize - [in] 限定录像文件的数据长度（单位：字节），NULL - 不限制
|
||||
saveNotify - [in] 录像事件通知接口指针
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXStartCapture(device_handle device, TCHAR* szFileName, BOOL saveAudio,
|
||||
unsigned* timeSize = NULL, unsigned* dataSize = NULL,
|
||||
ISaveNotify* saveNotify = NULL);
|
||||
|
||||
/*
|
||||
描述：
|
||||
停止录像
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXStopCapture(device_handle device);
|
||||
|
||||
/*
|
||||
描述：
|
||||
冻结录像部分（包括视频和音频）
|
||||
注意：!!! 适用于需要多段时间录像的情况
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
bFreeze - [in] TRUE - 冻结录像，FALSE - 解冻录像
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXFreezeCaputre(device_handle device, BOOL bFreeze);
|
||||
|
||||
/*
|
||||
描述：
|
||||
插入视频效果（针对原始视频数据）
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
ispTask - [in] 新插入的视频效果的接口指针
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXAttachIspTask(device_handle device, IispTask* ispTask);
|
||||
unsigned __stdcall DXDetachIspTask(device_handle device, IispTask* ispTask);
|
||||
|
||||
/*
|
||||
描述：
|
||||
编码视频数据回调的函数原型
|
||||
参数：
|
||||
fourcc - [in] 获取的编码数据的编码器的FOURCC
|
||||
buffer - [in] 缓冲区指针
|
||||
bufferSize - [out] 获取的编码数据的缓冲区大小（单位：字节）
|
||||
context - [in] 回调函数的上下文
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
typedef unsigned (__stdcall *fnEncVideoCallback)(unsigned fourcc, unsigned char* buffer, unsigned bufferSize, void* context);
|
||||
|
||||
/*
|
||||
描述：
|
||||
设置编码视频数据回调的函数
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
fn - [in] 回调函数指针，NULL - 停止回调
|
||||
context - [in] 回调函数的上下文
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXSetEncVideoCallback(device_handle device, fnEncVideoCallback fn, void* context);
|
||||
|
||||
/*
|
||||
描述：
|
||||
开始编码视频数据回调的函数
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
fn - [in] 回调函数指针，NULL - 停止回调
|
||||
context - [in] 回调函数的上下文
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXStartEncVideoCallback(device_handle device, fnEncVideoCallback fn, void* context);
|
||||
|
||||
/*
|
||||
描述：
|
||||
停止编码视频数据回调的函数
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXStopEncVideoCallback(device_handle device);
|
||||
|
||||
/*
|
||||
描述：
|
||||
使能去隔行功能
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
deinterlace - [in] 去隔行的算法类型
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXEnableDeinterlace(device_handle device, unsigned deinterlace);
|
||||
|
||||
/*
|
||||
描述：
|
||||
使能去噪功能
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
denoise - [in] 去噪的算法类型
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXEnableDenoise(device_handle device, unsigned denoise);
|
||||
|
||||
/*
|
||||
描述：
|
||||
使能伪彩功能
|
||||
参数：
|
||||
device - [in] 设备句柄
|
||||
szPColorTemplateFile - [in] 伪彩的模板文件。NULL - 停止使用伪彩
|
||||
pcolorDepth - [in] 伪彩的色深。此参数保留。
|
||||
返回值：
|
||||
0 - 成功；失败则返回错误代码
|
||||
// */
|
||||
unsigned __stdcall DXEnablePColor(device_handle device, TCHAR* szPColorTemplateFile, unsigned pcolorDepth);
|
||||
|
||||
unsigned __stdcall DXConvertYUVtoRGB(device_handle device, void* pYUVBuf,
|
||||
void* pRGBBuf,
|
||||
long lImgWidth,
|
||||
long lImgHeight,
|
||||
BOOL bInverted,
|
||||
BOOL bInvertColor);
|
||||
|
||||
#endif // __DXMEDIACAP_2011__
|
||||
Reference in New Issue
Block a user