通过

ICaptureGraphBuilder：：CopyCaptureFile 方法 (strmif.h)

  • 项目

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意ICaptureGraphBuilder 接口已弃用。 请改用 ICaptureGraphBuilder2 。
 
从预分配的捕获文件复制有效的媒体数据。

语法

HRESULT CopyCaptureFile(
  [in] LPOLESTR                   lpwstrOld,
  [in] LPOLESTR                   lpwstrNew,
  [in] int                        fAllowEscAbort,
  [in] IAMCopyCaptureFileProgress *pCallback
);

参数

[in] lpwstrOld

指向包含源文件名称的 Unicode™ 字符串的指针。

[in] lpwstrNew

指向包含目标文件名的 Unicode 字符串的指针。 有效数据将复制到此文件。

[in] fAllowEscAbort

指示按 ESC 键是否会取消复制操作的值。 TRUE 表示将; FALSE 表示此方法将忽略该击键。

[in] pCallback

指向 IAMCopyCaptureFileProgress 的可选指针显示复制操作的进度 (完成百分比) 。

返回值

返回 HRESULT 值。

注解

新文件将仅包含有效数据，因此可以比源文件短得多。 通常，将始终捕获到相同的大型预分配文件，并使用此方法将要从每个捕获保存的数据复制到新文件。

如果指定 pCallback，则 IAMCopyCaptureFileProgress 接口上的 Progress 方法将定期调用，其整数介于 0 和 100 之间，表示完成百分比。

要求

要求 值
目标平台 Windows
标头 strmif.h (包括 Dshow.h)

另请参阅

错误和成功代码

ICaptureGraphBuilder 接口