📄 dsstream.h
字号:
/*************************************************
**
** 文件名：DSStream.h
**
** 创建者：10Moons xiyi
**
** 创建时间：2001.02.25
**
** 最后更新：2001.07.31
**
** 说明：DSStream.dll API 函数的声明文件, ver 5.2
**
**************************************************/
#if !defined(DSSTREAM_H_2000_10_18)
#define DSSTREAM_H_2000_10_18
//用于枚举设备
//涉及函数：
// DSStream_EnumVideoCaptureDev()
// DSStream_EnumAudioCaptureDev()
#define MAX_DEVICE_NAME_LEN 80
#define MAX_DEVICE_NUM 32
//用于控制视频流的状态
//涉及函数：
// DSStream_GetStreamStatus()
// DSStream_SetStreamStatus()
#define RUN 0
#define PAUSE 1
#define STOP 2
//分别代表 Capture Pin 和 Preview Pin
//前者用于渲染录像流，后者用于渲染显示流
//涉及函数：
// DSStream_GetVideoInfo()
// DSStream_SetVideoInfo()
// DSStream_ConnectPin()
// DSStream_DeconnectPin()
#define CAPTURE 1
#define PREVIEW 2
//分别表示无人使用音频设备和音频设备不存在
//涉及函数：
// DSStream_WhoIsCapturingAudio()
#define AUDIO_DEVICE_NO_USED -1
#define AUDIO_DEVICE_NO_EXIST -2
//视频的子类型：RGB555、RGB24、YV12
//涉及：
// 结构 VIDEOSTREAMINFO
typedef enum
{
VideoSubType_None = -1,
VideoSubType_RGB555 = 0,
VideoSubType_RGB24,
VideoSubType_YUY2,
VideoSubType_YVU9,
VideoSubType_YV12,
} VideoSubType;
//视频流的各种信息
//涉及函数：
// DSStream_GetVideoInfo()
// DSStream_SetVideoInfo()
typedef struct
{
VideoSubType subtype;
RECT rcSource;
RECT rcTarget;
DWORD dwBitRate;
DWORD dwBitErrorRate;
LONGLONG AvgTimePerFrame;//帧率
BITMAPINFOHEADER bmiHeader; //宽、高、颜色位率等
} VIDEOSTREAMINFO;
//调用系统对话框设置各种音、视频属性
//涉及函数：
// DSStream_IsPropertyExist()
// DSStream_DisplayPropertyDialogs()
typedef enum
{
PropertyDlg_VideoCaptureFilter = 0,
PropertyDlg_VideoCapturePin, // *
PropertyDlg_VideoPreviewPin, // *
PropertyDlg_VideoCrossbar,
PropertyDlg_AudioCaptureFilter,
PropertyDlg_AudioCapturePin,
PropertyDlg_AudioCrossbar,
PropertyDlg_TVAudioFilter,
PropertyDlg_TVTuner,
PropertyDlg_VfwCaptureFormat, // *
PropertyDlg_VfwCaptureSource,
PropertyDlg_VfwCaptureDisplay,
} PropertyDialog;
//调用DirectShow COM 接口函数设置各种视频图像属性
//涉及函数：
// DSStream_GetVideoPropertyValue()
// DSStream_SetVideoPropertyValue()
typedef enum
{
VideoProperty_Brightness = 0, //亮度
VideoProperty_Contrast, //对比度
VideoProperty_Hue, //色度
VideoProperty_Saturation, //饱和度
VideoProperty_Gamma, //Gamma校验
VideoProperty_ColorEnable,
VideoProperty_WhiteBalance, //白平衡
VideoProperty_BacklightCompensation,
} VideoProperty;
//视频图像属性的各个值
//涉及函数：
// DSStream_GetVideoPropertyValue()
typedef struct
{
long lValue; //当前值
long lMin; //最小值
long lMax; //最大值
long lStepDelta; //最小步进值
long lDefault; //默认值
long lCapsFlags; //风格
} VIDEOPROPERTYRANGE;
//各种视频端口
//涉及函数：
// DSStream_GetVideoStandard()
// DSStream_SetVideoStandard()
typedef enum
{
VideoStandard_None = 0x00000000,
VideoStandard_NTSC_M = 0x00000001,
VideoStandard_NTSC_M_J = 0x00000002,
VideoStandard_NTSC_433 = 0x00000004,
VideoStandard_PAL_B = 0x00000010,
VideoStandard_PAL_D = 0x00000020,
VideoStandard_PAL_H = 0x00000080,
VideoStandard_PAL_I = 0x00000100,
VideoStandard_PAL_M = 0x00000200,
VideoStandard_PAL_N = 0x00000400,
VideoStandard_PAL_60 = 0x00000800,
VideoStandard_SECAM_B = 0x00001000,
VideoStandard_SECAM_D = 0x00002000,
VideoStandard_SECAM_G = 0x00004000,
VideoStandard_SECAM_H = 0x00008000,
VideoStandard_SECAM_K = 0x00010000,
VideoStandard_SECAM_K1 = 0x00020000,
VideoStandard_SECAM_L = 0x00040000,
VideoStandard_SECAM_L1 = 0x00080000,
} VideoStandard;
//视频状态改变或录像错误的代号:
//它作为LPARAM的低两个字节传给窗口（LPARAM的高两个字节表示卡号），
//即：Card ID = (LPARAM>>16) & 0x0000FFFFL，Errod code = (LPARAM & 0x0000FFFFL)
//涉及函数：
// DSStream_SetNotifyWindow()
// DSStream_ManageNotifyMessage()
typedef enum
{
Error_FirstNotifyMsg = 0x1234, //收到这个错误，必须调用 DSStream_ManageNotifyMessage()
Error_DiskFull, //磁盘已满：wparam=0
Error_VideoSizeChange, //视频流尺寸改变：height=HIWORD(wparam), width=LOWORD(wparam)
Error_StreamStatusChange, //视频流状态改变：wparam=0
Error_CaptureError, //录像异常：wparam=HRESULT: error value
} DSStreamError;
//视频压缩Filter的信息
//涉及函数：
// DSStream_EnumVideoCompressor()
typedef struct VIDEOCOMPRESSORINFO
{
char szName[80];
} VideoCompressorInfo;
//初始化和反初始化
HRESULT DSStream_Initialize();
void DSStream_Uninitialize();
//枚举系统中存在的视频、音频捕捉设备
HRESULT DSStream_EnumVideoCaptureDev(
char szDevName[MAX_DEVICE_NUM][MAX_DEVICE_NAME_LEN],
int *pDevNum);
HRESULT DSStream_EnumAudioCaptureDev(
char szDevName[MAX_DEVICE_NUM][MAX_DEVICE_NAME_LEN],
int *pDevNum);
//连接和断开视频捕捉设备
// iVideoDevID：视频捕捉设备的序号（以0为基数）
// bOverlay：TURE-Overlay, FALSE-Preview
HRESULT DSStream_ConnectDevice(int iCardID, BOOL bOverlay, HWND hParentWnd = NULL);
HRESULT DSStream_DisconnectDevice(int iCardID);
//获得关于多卡的数据
HRESULT DSStream_GetCardNumber(int * pCardNum);
HRESULT DSStream_IsConnected(int iCardID, BOOL * bConnected);
//谁获得声卡的使用权
void DSStream_WhoIsCapturingAudio(int * pCardID);
//视频显示窗口的父窗口
HRESULT DSStream_SetOwnerWnd(int iCardID, HWND hParentWnd);
HRESULT DSStream_GetOwnerWnd(int iCardID, HWND* phParentWnd);
//视频显示窗口在父窗口中的位置
HRESULT DSStream_SetWindowPos(int iCardID, RECT rc);
HRESULT DSStream_GetWindowPos(int iCardID, RECT* prc);
//录像时的.avi文件名
void DSStream_SetCaptureFile(int iCardID, LPCTSTR szFileName);
//开始录像
void DSStream_StartCapture(int iCardID);
//停止录像
void DSStream_StopCapture(int iCardID);
//是否正在录像
void DSStream_IsCapturing(int iCardID, BOOL* bIsCapturing);
//设置后，视频显示窗口的键盘和鼠标消息将发往窗口 hWnd
HRESULT DSStream_SetMessageDrain(int iCardID, HWND hWnd);
//设置后，每当DSStreamError产生时，窗口 hWnd 都将收到消息 lMsg（LPARAM = DSStreamError）
HRESULT DSStream_SetNotifyWindow(int iCardID, HWND hWnd, long lMsg);
//分析当前产生的事件，发送消息 lMsg 到窗口 hWnd
void DSStream_ManageNotifyMessage(int iCardID);
//全屏
HRESULT DSStream_FullScreen(int iCardID, BOOL bFullSrc);
HRESULT DSStream_IsFullSrcMode(int iCardID, BOOL* bIsFull);
//视频流的信息
// pin：CAPTURE Pin 或 PREVIEW Pin
HRESULT DSStream_GetVideoInfo(int iCardID, VIDEOSTREAMINFO * pVSI, int pin);
HRESULT DSStream_SetVideoInfo(int iCardID, VIDEOSTREAMINFO vsi, int pin);
//调用系统对话框设置各种音、视频属性
// id：属性代号
// hParentWnd：系统对话框的父窗口
// szCaption：系统对话框的标题
HRESULT DSStream_DisplayPropertyDialogs(int iCardID, PropertyDialog id, HWND hParentWnd, LPCTSTR szCaption=NULL);
//各种音、视频属性是否可被调用
HRESULT DSStream_IsPropertyExist(int iCardID, PropertyDialog id, BOOL* bReturn);
//各种视频图像属性
HRESULT DSStream_GetVideoPropertyValue(int iCardID, VideoProperty id, VIDEOPROPERTYRANGE* pVPR);
HRESULT DSStream_SetVideoPropertyValue(int iCardID, VideoProperty id, long value);
//专用于四路卡：在四路同屏时调节单路图像的视频属性
HRESULT DSStream_GetVideoPropertyValue_Ex(int iCardID, long lWay, VideoProperty id, long * pValue);
HRESULT DSStream_SetVideoPropertyValue_Ex(int iCardID, long lWay, VideoProperty id, long lValue);
//视频端口
HRESULT DSStream_RouteInPinToOutPin(int iCardID, int idInPin, int idOutPin);
HRESULT DSStream_WhatInPinRouteToOutPin(int iCardID, int idOutPin, long* pInPin);
//视频制式
// VideoStandard：当前制式
// pAvailable：返回设备支持的所有制式
HRESULT DSStream_GetVideoStandard(int iCardID, VideoStandard* pVideoStandard, long* pAvailable);
HRESULT DSStream_SetVideoStandard(int iCardID, VideoStandard vs);
//快照：JPG
// szFileName：.jpg 文件的全路径名
// iQuality：压缩质量（10-100）
HRESULT DSStream_SaveToJpgFile(int iCardID, LPCTSTR szFileName, int iQuality);
//快照：BMP
HRESULT DSStream_SaveToBmpFile(int iCardID, LPCTSTR szFileName);
//得到当前图像的 DIB 数据。若 pBuffer 等于 NULL，pSize 得到保存图像所需要的内存大小
HRESULT DSStream_GetCurrentDib(int iCardID, BYTE* pBuffer, long* pSize);
//当前的显示状态
HRESULT DSStream_GetStreamStatus(int iCardID, int* pStatus);
HRESULT DSStream_SetStreamStatus(int iCardID, int status);
//录像时是否使用自定义的帧率（duFrameRate = 0-30）
void DSStream_SetFrameRateOnCapture(int iCardID, BOOL bUseFrameRate, double duFrameRate);
void DSStream_IsUseFrameRate(int iCardID, BOOL* pYesOrNo);
//录像时是否捕捉音频
void DSStream_IsCaptureAudio(int iCardID, BOOL* bCaptureAudio);
void DSStream_SetCaptureAudio(int iCardID, BOOL* bCaptureAudio);
//断开、连接某个Pin上连接的所有Filter
void DSStream_DisconnectPin(int iCardID, int pin);
void DSStream_ConnectPin(int iCardID, int pin);
//调试用：打印所有Filter的连接状况到文件 szFile 中
void DSStream_ListAllFilter(int iCardID, LPCTSTR szFile);
//察看 PREVIEW Pin 是否存在
HRESULT DSStream_IsPreviewPinExisted(int iCardID, BOOL* pbExisted);
//获取DIB数据流
extern "C"
{
typedef void (__stdcall *VideoStreamProc) (const BYTE* pDIBHead, const BYTE* pDIBits, LPVOID pParam);
}
HRESULT DSStream_GetVideoStream(int iCardID, VideoStreamProc proc, LPVOID pParam);
//设置Logo、Time、Date的显示
// 设置表示Logo的BMP文件，必须为24位，最左下角的一点为透明色
HRESULT DSStream_SetLogoFile(int iCardID, LPCTSTR szFilename);
// 显示或隐藏Logo
HRESULT DSStream_ShowLogo(int iCardID, BOOL bShow, int x, int y);
// 显示或隐藏Time
HRESULT DSStream_ShowTime(int iCardID, BOOL bShow, int x, int y);
// 显示或隐藏Date
HRESULT DSStream_ShowDate(int iCardID, BOOL bShow, int x, int y);
// 是否在由DSStream_GetVideoStream()得到的数据流中显示Logo、Time、Date
// 影响的函数：
// DSStream_GetVideoStream()
HRESULT DSStream_ShowLogoTimeOnUserStream(int iCardID, BOOL bShow);
//专用于带矩阵的四路卡：矩阵调节，以 0 为基数
//idCamera >= 32 时，第 idWay 路无图像。
HRESULT DSStream_ChooseCamera_Ex(int iCardID, BYTE idWay, BYTE idCamera);
//得到视频压缩Filter的信息
HRESULT DSStream_EnumVideoCompressor(VideoCompressorInfo * pInfo, int * piVidCompNum);
//选择视频压缩算法
HRESULT DSStream_ChooseVideoCompressor(LPCTSTR szCompName);
//看看当前使用的是什么压缩算法
HRESULT DSStream_GetCurrentVideoCompressor(LPSTR pszCompName);
//视频压缩的质量(0--100)
HRESULT DSStream_GetVideoCompressorQuality(int * piQuality);
HRESULT DSStream_SetVideoCompressorQuality(int iQuality);
//检测当前的视频输入端口上是否有信号输入
HRESULT DSStream_IsVideoSignalLocked(int iCardID, BOOL * bIsSignalLocked);
#endif //!defined(DSSTREAM_H_2000_10_18)⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -