[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器 和 接收寫入器已取代它。 來源讀取器 和 接收寫入器 已針對 Windows 10 和 Windows 11 優化。 Microsoft強烈建議新程式代碼盡可能使用 來源讀取器 和 接收寫入器,而不是 Windows Media Format 11 SDK。 Microsoft建議使用舊版 API 的現有程式代碼,盡可能改寫成使用新的 API。]
在正常情況下,您只要使用 IWMWriter::SetOutputFilename 方法傳遞輸出檔名,寫入器物件就會自動將檔案寫入磁碟。 在此情況下,寫入程序實際上會建立及控制寫入檔案接收器物件,以處理將檔案寫入磁碟。 寫入器檔案接點物件會控制從寫入器物件到單一檔案的資料流。
您可以建立自己的檔案接收器,以更佳方式控制接收器寫入檔案的方式。 您也可以存取寫入器因應 SetOutputFilename呼叫而建立的預設寫入器文件接收器。
建立檔案儲存端
若要建立檔案匯入並將其加入寫入器,請執行下列步驟。
- 呼叫 WMCreateWriterFileSink 函式,來建立新的接收器。
- 呼叫 IWMWriterFileSink::Open來指定作為接收端的檔案名稱。
- 呼叫 IWMWriterAdvanced::AddSink,以將檔案接收器新增至寫入器。
- 以一般方式進行寫入。
- 寫入完成之後,接收器會自動關閉檔案。
停止和啟動檔案匯出器
開始寫入作業之後,您可以呼叫 IWMWriterFileSink2::Stop來停止向文件接收器寫入。
有許多可能的原因會導致您想停止寫入接收器。 例如,如果您要從即時來源錄製,您可能只對部分內容感興趣。
您可以透過呼叫 IWMWriterFileSink2::Start,來繼續向檔案接收端寫入。 停止 和 開始 使用呈現時間來大致控制命令執行的時間。 您可以使用 IWMWriterFileSink3 方法來取得更多開始和停止時間的控制。
關閉檔案匯入點
一般而言,檔案匯出器會自動關閉。 如果您已完成寫入某個接收器,但寫入其他接收器的操作仍在繼續,您應該確實關閉該接收器以節省資源。 若要關閉檔案接收器,請呼叫 IWMWriterFileSink2::Close。
取得接收端統計數據
您可以分別呼叫 IWMWriterFileSink2::GetFileSize 和 IWMWriterFileSink2::GetFileDuration,以取得開啟的寫入接收檔案的大小和持續時間。
相關主題