1.关于avicap32.dll基本概念
VFW(Video For Window)技术是Microsoft公司为开发Windows平台下的视频应用程序提供的软件工具包,提供了一系列应用程序编程接口(API),用户可以通过这些接口很 方便地实现视频捕获、视频编辑及视频播放等通用功能,还可利用回调函数开发比较复杂的视频应用程序。该技术的特点是播放视频时不需要专用的硬件设备,而且 应用灵活,可以满足视频应用程序开发的需要。Windows操作系统自身就携带了VFW技术,系统安装时,会自动安装VFW的相关组件。
AVICAP32.DLL:包含执行视频捕获的函数,给AVI文件的I/O处理和视频,音频设备驱动程序提供一个高级接口。 MSVIDEO.DLL:包含一套特殊的DrawDib函数,用来处理程序上的视频操作。MCIAVI.DRV:包括对VFW的MCI命令解释器的驱动程序。AVIFILE.DLL:包含由标准多媒体I/O(mmio)函数提供的更高级的命令,用来访问.AVI文件。ICM:压缩管理器,用于管理的视频压缩/解压缩的编译码器。ACM:音频压缩管理器,提供与ICM相似的服务,适用于波形音频。
2.关于avicap32.dll重要函数的参数的介绍
(1)capCreateCaptureWindow函数
该函数用于创建一个视频捕捉窗口。语法如下:
[DllImport("avicap32.dll")]
public static extern IntPtr capCreateCaptureWindowA(byte[] lpszWindowName, int dwStyle, int x, int y, int nWidth, int nHeight, IntPtr hWndParent, int nID);
参数说明如下。
l lpszWindowName:标识窗口的名称。
l dwStyle:标识窗口风格。
l x、y:标识窗口的左上角坐标。
l nWidth、nHeight:标识窗口的宽度和高度。
l hWnd:标识父窗口句柄。
l nID:标识窗口ID。
l 返回值:视频捕捉窗口句柄。
(2)SendMessage函数
用于向Windows系统发送消息机制。
[DllImport("User32.dll")]
private static extern bool SendMessage(IntPtr hWnd, int wMsg, int wParam, int lParam);
参数说明如下。
l hWnd:窗口句柄。
l wMsg:将要发送的消息。
l wParam、lParam:消息的参数,每个消息都有两个参数,参数设置由发送的消息而定。
3.
using System; using System.Runtime.InteropServices; using System.Drawing; using System.Text; namespace AVI { public class AviCapture { #region 导入API函数 [DllImport("avicap32.dll")]//包含了执行视频捕获的函数,它给AVI文件I/O和视频、音频设备驱动程序提供一个高级接口 public static extern IntPtr capCreateCaptureWindow(string lpszWindowName, int dwStyle, int x, int y, int nWidth, int nHeight, IntPtr hwndParent, int nID); /************参数说明************* * * 函数:capCreateCaptureWindow * * lpszWindowName:标识窗口的名称 * dwStyle:标识窗口风格 * x、y:标识窗口的左上角坐标 * nWidth、nHeight:标识窗口的宽度和高度 * hWnd:标识父窗口句柄 * nID:标识窗口ID * * 返回值:视频捕捉窗口句柄。 * ********************************/ [DllImport("AVICAP32.dll", CharSet = CharSet.Unicode)] public static extern bool capGetDriverDescription(int wDriverIndex, StringBuilder lpszName, int cbName, StringBuilder lpszVer, int cbVer); [DllImport("User32.dll")] public static extern bool SendMessage(IntPtr hWnd, int wMsg, bool wParam, int lParam); [DllImport("User32.dll")] public static extern bool SendMessage(IntPtr hWnd, int wMsg, short wParam, int lParam); [DllImport("User32.dll")] public static extern bool SendMessage(IntPtr hWnd, int wMsg, int wParam, int lParam); [DllImport("User32.dll")] public static extern bool SendMessage(IntPtr hWnd, int wMsg, short wParam, FrameEventHandler lParam); [DllImport("User32.dll")] public static extern bool SendMessage(IntPtr hWnd, int wMsg, int wParam, ref BITMAPINFO lParam); [DllImport("User32.dll")] public static extern bool SendMessage(IntPtr hWnd, int wMsg, int wParam, ref CAPDRIVERCAPS lParam); [DllImport("User32.dll")] public static extern bool SendMessage(IntPtr hWnd, int wMsg, int wParam, ref CAPTUREPARMS lParam); [DllImport("User32.dll")] public static extern bool SendMessage(IntPtr hWnd, int wMsg, int wParam, ref CAPSTATUS lParam); [DllImport("User32.dll")] public static extern int SetWindowPos(IntPtr hWnd, int hWndInsertAfter, int x, int y, int cx, int cy, int wFlags); [DllImport("avicap32.dll")] public static extern int capGetVideoFormat(IntPtr hWnd, IntPtr psVideoFormat, int wSize); #endregion #region 消息常量(向窗口发送消息的指令) //消息常量 -------------------------------------------- public const int WM_START = 0x400; //此并非摄像头消息0x400表示的就是1024 public const int WS_CHILD = 0x40000000; public const int WS_VISIBLE = 0x10000000; public const int SWP_NOMOVE = 0x2; public const int SWP_NOZORDER = 0x4; public const int WM_CAP_GET_CAPSTREAMPTR = WM_START + 1; public const int WM_CAP_SET_CALLBACK_ERROR = WM_START + 2;//设置收回错误 public const int WM_CAP_SET_CALLBACK_STATUS = WM_START + 3;//设置收回状态 public const int WM_CAP_SET_CALLBACK_YIELD = WM_START + 4;//设置收回出产 public const int WM_CAP_SET_CALLBACK_FRAME = WM_START + 5;//设置收回结构 public const int WM_CAP_SET_CALLBACK_VIDEOSTREAM = WM_START + 6;//设置收回视频流 public const int WM_CAP_SET_CALLBACK_WAVESTREAM = WM_START + 7;//设置收回视频波流 public const int WM_CAP_GET_USER_DATA = WM_START + 8;//获得使用者数据 public const int WM_CAP_SET_USER_DATA = WM_START + 9;//设置使用者数据 public const int WM_CAP_DRIVER_CONNECT = WM_START + 10;//驱动程序连接 public const int WM_CAP_DRIVER_DISCONNECT = WM_START + 11;//断开启动程序连接 public const int WM_CAP_DRIVER_GET_NAME = WM_START + 12;//获得驱动程序名字 public const int WM_CAP_DRIVER_GET_VERSION = WM_START + 13;//获得驱动程序版本 public const int WM_CAP_DRIVER_GET_CAPS = WM_START + 14;//获得驱动程序帽子 public const int WM_CAP_FILE_SET_CAPTURE_FILE = WM_START + 20;//设置捕获文件 public const int WM_CAP_FILE_GET_CAPTURE_FILE = WM_START + 21;//获得捕获文件 public const int WM_CAP_FILE_ALLOCATE = WM_START + 22;//分派文件 public const int WM_CAP_FILE_SAVEAS = WM_START + 23;//另存文件为 public const int WM_CAP_FILE_SET_INFOCHUNK = WM_START + 24;//设置开始文件 public const int WM_CAP_FILE_SAVEDIB = WM_START + 25;//保存文件 public const int WM_CAP_EDIT_COPY = WM_START + 30;//编辑复制 public const int WM_CAP_SET_AUDIOFORMAT = WM_START + 35;//设置音频格式 public const int WM_CAP_GET_AUDIOFORMAT = WM_START + 36;//捕获音频格式 public const int WM_CAP_DLG_VIDEOFORMAT = WM_START + 41;//1065 打开视频格式设置对话框 public const int WM_CAP_DLG_VIDEOSOURCE = WM_START + 42;//1066 打开属性设置对话框,设置对比度亮度等 public const int WM_CAP_DLG_VIDEODISPLAY = WM_START + 43;//1067 打开视频显示 public const int WM_CAP_GET_VIDEOFORMAT = WM_START + 44;//1068 获得视频格式 public const int WM_CAP_SET_VIDEOFORMAT = WM_START + 45;//1069 设置视频格式 public const int WM_CAP_DLG_VIDEOCOMPRESSION = WM_START + 46;//1070 打开压缩设置对话框 public const int WM_CAP_SET_PREVIEW = WM_START + 50;//设置预览 public const int WM_CAP_SET_OVERLAY = WM_START + 51;//设置覆盖 public const int WM_CAP_SET_PREVIEWRATE = WM_START + 52;//设置预览比例 public const int WM_CAP_SET_SCALE = WM_START + 53;//设置刻度 public const int WM_CAP_GET_STATUS = WM_START + 54;//获得状态 public const int WM_CAP_SET_SCROLL = WM_START + 55;//设置卷 public const int WM_CAP_GRAB_FRAME = WM_START + 60;//逮捕结构 public const int WM_CAP_GRAB_FRAME_NOSTOP = WM_START + 61;//停止逮捕结构 public const int WM_CAP_SEQUENCE = WM_START + 62;//次序 public const int WM_CAP_SEQUENCE_NOFILE = WM_START + 63;//使用WM_CAP_SEUENCE_NOFILE消息(capCaptureSequenceNoFile宏),可以不向磁盘文件写入数据。该消息仅在配合回调函数时有用,它允许你的应用程序直接使用音视频数据。 public const int WM_CAP_SET_SEQUENCE_SETUP = WM_START + 64;//设置安装次序 public const int WM_CAP_GET_SEQUENCE_SETUP = WM_START + 65;//获得安装次序 public const int WM_CAP_SET_MCI_DEVICE = WM_START + 66;//设置媒体控制接口 public const int WM_CAP_GET_MCI_DEVICE = WM_START + 67;//获得媒体控制接口 public const int WM_CAP_STOP = WM_START + 68;//停止 public const int WM_CAP_ABORT = WM_START + 69;//异常中断 public const int WM_CAP_SINGLE_FRAME_OPEN = WM_START + 70;//打开单一的结构 public const int WM_CAP_SINGLE_FRAME_CLOSE = WM_START + 71;//关闭单一的结构 public const int WM_CAP_SINGLE_FRAME = WM_START + 72;//单一的结构 public const int WM_CAP_PAL_OPEN = WM_START + 80;//打开视频 public const int WM_CAP_PAL_SAVE = WM_START + 81;//保存视频 public const int WM_CAP_PAL_PASTE = WM_START + 82;//粘贴视频 public const int WM_CAP_PAL_AUTOCREATE = WM_START + 83; //自动创造 public const int WM_CAP_PAL_MANUALCREATE = WM_START + 84;//手动创造 public const int WM_CAP_SET_CALLBACK_CAPCONTROL = WM_START + 85;// 设置收回的错误 #endregion 消息常量 #region 结构体 /*********VideoHdr 结构体********* * * 定义了视频数据块的头信息, * 在编写回调函数时常用到其数据成员lpData(指向数据缓存的指针)和dwBufferLength(数据缓存的大小)。 * 视频帧到缓存的捕获则需要应用回调函数和相应的数据块结构 VIDEOHDR * *******************************/ [StructLayout(LayoutKind.Sequential)] public struct VIDEOHDR { public IntPtr lpData; /* 指向数据缓存的指针 */ public int dwBufferLength; /* 数据缓存的大小 */ public int dwBytesUsed; /* Bytes actually used */ public int dwTimeCaptured; /* Milliseconds from start of stream */ public int dwUser; /* for client\'s use */ public int dwFlags; /* assorted flags (see defines) */ public int dwReserved; /* reserved for driver */ } /*********BitmapInfoHeader 结构体********* * * BitmapInfoHeader定义了位图的头部信息 * ****************************************/ [StructLayout(LayoutKind.Sequential)] public struct BITMAPINFOHEADER { public int biSize; public int biWidth; public int biHeight; public short biPlanes; public short biBitCount; public int biCompression; public int biSizeImage; public int biXPelsPerMeter; public int biYPelsPerMeter; public int biClrUsed; public int biClrImportant; } /*********BitmapInfo 结构体********* * * BitmapInfo 定义了位图信息 * ***********************************/ [StructLayout(LayoutKind.Sequential)] public struct BITMAPINFO { public BITMAPINFOHEADER bmiHeader; public int bmiColors; } /*********CAPTUREPARMS 结构体********* * * CAPTUREPARMS 包含控制视频流捕获过程的参数,如捕获帧频、指定键盘或鼠标键以终止捕获、捕获时间限制等 * ***********************************/ [StructLayout(LayoutKind.Sequential)] public struct CAPTUREPARMS { public int dwRequestMicroSecPerFrame; // 期望的桢播放率,以毫秒为单位,默认为66667,相当于15桢每秒。 public bool fMakeUserHitOKToCapture; // Show "Hit OK to cap" dlg?开始捕获标志位,如果值为真,则在开始捕获前要产生一个询问对话框,默认为假。 public uint wPercentDropForError; //所允许的最大丢桢百分比,可以从0变化到100,默认值为10。 public bool fYield; /*另起线程标志位,如果为真,则程序重新启动一个线程用于视频流的捕获,默认值是假。 但是如果你是为了真,你必须要在程序中处理一些潜在的操作,因为当视频捕获时,其他操作并没有被屏蔽。*/ public int dwIndexSize; // 在AVI文件中所允许的最大数目的索引项(32K) public uint wChunkGranularity; // AVI文件的逻辑尺寸,以字节为单位。如果值是0,则说明该尺寸渐增 在 Win32程序中无用。(2K) public bool fUsingDOSMemory; // Use DOS buffers? public uint wNumVideoRequested; // 所被允许分配的最大视频缓存 public bool fCaptureAudio; // 音频标志位,如果音频流正在捕获,则该值为真。 public uint wNumAudioRequested; // 最大数量的音频缓存,默认值为10。 public uint vKeyAbort; // 终止流捕获的虚拟键盘码,默认值为VK_ESCAPE [MarshalAs(UnmanagedType.Bool)] public bool fAbortLeftMouse; // 终止鼠标左键标志位,如果该值为真,则在流捕获过程中如果点击鼠标左键则该捕获终止,默认值为真。 public bool fAbortRightMouse; // Abort on right mouse? public bool fLimitEnabled; // 捕获操作时间限制,如果为真,则时间到了以后捕获操作终止,默认为假 public uint wTimeLimit; // 具体终止时间,只有 fLimitEnabled是真时.该位才有效 public bool fMCIControl; // Use MCI video source? public bool fStepMCIDevice; // Step MCI device?MCI 设备标志。 public int dwMCIStartTime; // Time to start in MS public int dwMCIStopTime; // Time to stop in MS public bool fStepCaptureAt2x; // Perform spatial averaging 2x public int wStepCaptureAverageFrames; // 当基于平均采样来创建桢时,桢的采样时间,典型值是5 public int dwAudioBufferSize; // 音频缓存的尺寸,如果用默认值0,缓存尺寸是最大0.5秒,或10k字节。 public int fDisableWriteCache; // Attempt to disable write cache public int AVStreamMaster; //音视频同步标志。 } /*********CAPDRIVERCAPS 结构体********* * * CAPDRIVERCAPS 定义了捕获驱动器的能力,如有无视频叠加能力、有无控制视频源、视频格式的对话框等 * **************************************/ [StructLayout(LayoutKind.Sequential)] public struct CAPDRIVERCAPS { [MarshalAs(UnmanagedType.U2)] public UInt16 wDeviceIndex; //捕获驱动器的索引值,该值可以由0到9变化。 [MarshalAs(UnmanagedType.Bool)] public bool fHasOverlay; // 视频叠加标志,如果设备支持视频叠加这该位是真。 [MarshalAs(UnmanagedType.Bool)] public bool fHasDlgVideoSource; //视频资源对话框标志位,如果设备支持视频选择、控制对话框,该值为真。 [MarshalAs(UnmanagedType.Bool)] public bool fHasDlgVideoFormat; //视频格式对话框标志位,如果设备支持对视频格式对话框的选择,该位真。 [MarshalAs(UnmanagedType.Bool)] public bool fHasDlgVideoDisplay; //视频展示对话框标志位,如果设备支持对视频捕获缓存区的重新播放,该位是真。 [MarshalAs(UnmanagedType.Bool)] public bool fCaptureInitialized; //捕获安装标志位,如果捕获驱动器已经成功连接,该值为真。 //[MarshalAs(UnmanagedType.Bool)] public bool fDriverSuppliesPalettes; //驱动器调色板标志位,如果驱动器能创建调色板,则该位是真。 [MarshalAs(UnmanagedType.I4)] public int hVideoIn; [MarshalAs(UnmanagedType.I4)] public int hVideoOut; [MarshalAs(UnmanagedType.I4)] public int hVideoExtIn; [MarshalAs(UnmanagedType.I4)] public int hVideoExtOut; } /*********CAPSTATUS 结构体********* * * CAPSTATUS 定义了捕获窗口的当前状态,如图像的宽、高等 * **************************************/ [StructLayout(LayoutKind.Sequential)] public struct CAPSTATUS { public int uiImageWidth; //图像宽度 public int uiImageHeight; //图像高度 public bool fLiveWindow; //活动窗口标记,如果窗口正以预览的方式展示图像,那么该值为真 public bool fOverlayWindow; //叠加窗口标志位,如果正在使用硬件叠加,则该位是真。 public bool fScale; //输入所放标志位,如果窗口是正在缩放视频到客户区,那么该位是真。当使用硬件叠加时,改位无效。 public Point ptScroll; //被展示在窗口客户区左上角的那个象素的x、y坐标偏移量。 public bool fUsingDefaultPalette; //默认调色板标志位,如果捕获窗口正在使用当前默认调色板,该值为真 public bool fAudioHardware; // 音频硬件标志位,如果系统已经安装了音频硬件,该值为真。 public bool fCapFileExists; //捕获文件标志位,如果一个捕获文件已经被创建,该值为真 public int dwCurrentVideoFrame; // 当前或最近流捕获过程中,所处理的桢的数目。包括丢弃的桢。 public int dwCurrentVideoFramesDropped;//当前流捕获过程中丢弃的桢的数目。 public int dwCurrentWaveSamples; // # of wave samples cap\'td public int dwCurrentTimeElapsedMS; // 从当前流捕获开始计算,程序所用的时间,以毫秒为单位。 public IntPtr hPalCurrent; // 当前剪切板的句柄。 public bool fCapturingNow; // 捕获标志位,当捕获是正在进行时,改位是真 public int dwReturn; // 错误返回值,当你的应用程序不支持错误回调函数时可以应用改位 public int wNumVideoAllocated; // 被分配的视频缓存的数目。 public int wNumAudioAllocated; // 被分配的音频缓存的数目。 } #endregion #region 基本函数 public delegate void FrameEventHandler(IntPtr lwnd, IntPtr lpVHdr); public static object GetStructure(IntPtr ptr, ValueType structure) { return Marshal.PtrToStructure(ptr, structure.GetType()); } public static object GetStructure(int ptr, ValueType structure) { return GetStructure(new IntPtr(ptr), structure); } public static void Copy(IntPtr ptr, byte[] data) { Marshal.Copy(ptr, data, 0, data.Length); } public static void Copy(int ptr, byte[] data) { Copy(new IntPtr(ptr), data); } public static int SizeOf(object structure) { return Marshal.SizeOf(structure); } #endregion } }