AVI文件数据流操作

Video for Windows (VFW)在16位Windows中就引入了，现在的很多功能被DirectX所代替或超越了。但是还是有一些用处的。
Audio-video-interleaved file（AVI）文件：视频序列，音频轨道

【使用AVIFile函数和宏时DLL的加载和释放】

• 函数和宏都包含在一个dll里面
• 用AVIFileInit函数初始化dll引用
• 初始化成功后，才可以使用全部的AVIFile函数和宏
• 用AVIFileExit来释放dll引用

【AVI文件打开、关闭和读写】

• 任何读写用AVIFileOpen函数打开文件，支持OpenFile函数类似的OF_系列标志
• AVIFileOpen函数本身会自动增加文件的引用计数，但是遇到你需要将已经打开的文件句柄传送给其他的应用程序的情况，在传送之前需要使用AVIFileAddRef函数来人为增加文件的引用计数
• 用AVIFileRelease函数来“关闭文件”，它减少文件的引用计数，保存程序对文件的修改，当引用计数降到0的时候才真正关闭文件
• AVIFileOpen和AVIFileAddRef会增加引用计数，AVIFileRelease会减少引用计数，所以在应用程序中你要自己控制这种“平衡”工作。最佳实践：应用程序里面，同一时刻对一个AVI文件的访问只有一个线程
• 用AVIFileInfo读取文件信息到AVIFILEINFO结构中
• 用AVIFileReadData读取其他额外的不在通常的文件头里面的信息
• 用AVIFileWriteData将其他额外的信息写入打开的文件中
• 剪切板功能：AVIPutFileOnClipboard拷贝一个文件进剪切板，AVIGetFromClipboard将剪切板的数据写到内存或磁盘上；AVIClearClipboard清除剪切板中的AVI文件数据（但它不会清除文本等剪切板里面其他的数据），应该在应用程序关闭或剪切板的AVI文件关闭之前使用

【AVI文件数据流操作——概要】

• 类直接操作文件类似，用AVIFileGetStream函数得到已经打开的AVI文件的一个数据流，并对数据流做引用计数
• 还有一个AVISteamOpenFromFile函数，直接集成了AVIFileOpen和AVIFileGetStream的功能
• 如果操作一个文件里的多个数据流？用AVIFileOpen打开文件，接着用多个AVIFileGetStream调用即可
• 用AVIStreamAddRef会增加数据流的引用计数，可以防止有些函数调用后关闭数据流
• 用AVIStreamRelease函数来“关闭数据流”，它减少数据流的引用计数，当引用计数降到0的时候才关闭数据流
• 和文件操作一样，需要“平衡”AVIFileGetStream、AVIFileCreateStream、AVIStreamAddRef、AVISteamOpenFromFile与AVIStreamRelease之间的调用关系

【AVI文件数据流操作——读】

• 用AVIStreamInfo函数读取一个已经打开的数据流的信息到AVISTREAMINFO结构里面，包含数据类型，压缩方式，建议的缓冲区大小，回放率和数据流的文本描述等。有些信息在AVIFILEINFO结构里面已经有了，但是后者是针对整个文件的，AVISTREAMINFO结构有更多的关于该数据流的信息
• 用AVIStreamReadData函数读取数据流的额外信息，可能包含了数据流的压缩和解压缩方法的配置信息，可以使用AVIStreamDataSize宏得到所必须的缓冲区大小
• 用AVIStreamReadFormat函数得到数据流的格式信息。对于视频缓冲区包含了一个BITMAPINFO结构；对于音频缓冲区包含了一个WAVEFORMATEX或者PCMWAVEFORMAT结构；如果要得到格式缓冲区的大小，给函数传一个指向NULL的缓冲区指针或者使用AVIStreamFormatSize宏得到
• 用AVIStreamRead读取数据流中真正的多媒体内容数据。对于视频，得到的是帧里面的位图图像；对于音频，得到的是波形采样的声音数据；如果要得到数据缓冲区的大小，给函数传一个指向NULL的缓冲区指针或者使用AVIStreamSampleSize宏得到；这个函数没有帮你处理解压缩数据的操作。用DrawDib系列函数可以直接显示帧里面的压缩数据图像。
• 如果有些数据流句柄引入了和软件或硬件初始化的延时。需要用AVIStreamBeginStreaming函数来通知这些句柄分配资源和做相应的初始化工作，数据访问结束后用AVIStreamEndStreaming函数来通知它们释放资源和做相应的清理工作
• 用AVIStreamGetFrameOpen函数分配解压缩帧需要的缓冲区
• 用AVIStreamGetFrame函数解压缩一个帧，返回BITMAPINFOHEADER结构里面的DIB指针地址，然后可以用标准画图函数或DrawDib系列函数显示图像
• 用AVIStreamGetFrameClose函数释放资源

【AVI文件数据流操作——写】

• 用AVISave函数将一个或多个数据流保存到文件中，同样AVISaveV除了参数不一样效果类似。在参数中可以设定一个用来表示保存进度的回调函数
• 用AVISaveOptions函数弹出一个可以设置压缩选项的对话框，用户可以编辑选项，并保存在AVICOMPRESSOPTIONS结构中
• 用GetSaveFileNamePreview函数可以弹出对话框让用户重新设置文件名，并可以预览视频中的第一个数据流
• 用AVIMakeFileFromStreams函数从一组数据流中创建一个文件接口指针（和一个虚拟文件），它返回一个文件句柄，其他AVI文件操作函数可以使用这个句柄，用AVIFileRelease函数来释放文件指针
• 用AVIFileCreateStream函数在一个文件（可以是已经存在的）中直接创建一个新的数据流，数据流的特性由AVISTREAMINFO结构参数决定，将数据流的引用计数增加后返回该数据流的接口句柄地址
• 在真正写入数据流数据之前，用AVIStreamSetFormat函数设置数据流的格式。针对视频，使用BITMAPINFO结构参数；针对音频，使用WAVEFORMAT或WAVEFORMATEX结构参数
• 真正写数据用AVIStreamWrite函数，默认都是将数据追加到数据流的最后
• 用AVIStreamRelease函数关闭数据流，它做一些清理工作
• 和数据流相关的额外信息（例如，压缩/解压缩信息）用AVIStreamWriteData函数加到文件中；和文件相关的额外信息（例如，版本、修改信息）用AVIFileWriteData函数加到文件中；这些信息都保持在文件的独立数据块中

【AVI文件数据流操作——定位】

• 用AVIStreamStart函数返回值得到数据流中第一帧的位置；也可以用AVIStreamInfo函数得到数据流的信息，它会填充一个AVISTREAMINFO结构，其中的dwStart表示了第一帧的位置；也可以用AVIStreamStartTime宏返回值得到数据流中第一帧的时间
• 和上述类似，用AVIStreamLength函数返回值得到整个数据流的长度（采样数）；也可以用AVIStreamInfo函数得到数据流的信息，它填充的AVISTREAMINFO结构中的dwLength表示了这个长度；也可以用AVIStreamLengthTime宏得到整个数据流的时间（单位毫秒）
• 针对视频，每个采样对应相应的视频帧，用AVIStreamRead函数来读取数据，但是会碰到读取的数据长度是0的情况
• 针对音频，每个采样对应相应的音频数据块，…
• 用AVIStreamEnd函数得到数据流末尾的采样数；用AVIStreamEndTime函数得到数据流末尾的采样时间
• AVIStreamFindSample函数利用FIND_ANY标志可以直接找到不为空的数据流，也可以用其他的标志来找到不同类型的数据帧，例如：FIND_KEY，FIND_FORMAT
• 还有两个函数需要注意：AVIStreamSampleToTime和AVIStreamTimeToSample

【AVI文件数据流操作——编辑】

• 用AVIStreamCreate函数在内存中创建临时的数据流；或者用AVIMakeCompressedStream函数从未压缩的数据流中创建压缩的数据流，它们都返回数据流的指针地址，用AVIStreamRelease函数来释放资源
• 用CreateEditableStream函数创建一个可编辑的环境，返回一个可编辑的数据流指针，其他编辑函数应该用这个指针，而不是源数据流的指针
• 相关的编辑函数有：EditStreamCut，EditStreamCopy，EditStreamPaste，EditStreamClone，EditStreamSetInfo，EditStreamSetName，AVIMakeFileFromStream和AVISTREAMINFO结构