共用方式為

iCaptureGraphBuilder：：CopyCaptureFile 方法 (strmif.h)

  • 發行項

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 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 介面