共用方式為

AVISaveA 函式 （vfw.h）

  • 發行項

AVISave 函式會結合來自其他檔案或記憶體的數據流來建置檔案。

語法

HRESULT AVISaveA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           pfile,
  LPAVICOMPRESSOPTIONS lpOptions,
  ...                  
);

參數

szFile

包含要儲存之檔名的 Null 終止字串。

pclsidHandler

用來寫入檔案之檔案處理程式的指標。 檔案的建立方式是使用此處理程式呼叫 AVIFileOpen 函式。 如果未指定處理程式，則會根據擴展名從登錄選取預設值。

lpfnCallback

儲存作業的回呼函式指標。

nStreams

儲存在檔案中的數據流數目。

pfile

AVI 數據流的指標。 此參數會與 lpOptions配對。 參陣列可以重複為變數數目的自變數。

lpOptions

應用程式定義的 AVICOMPRESSOPTIONS 結構的指標，其中包含pavi 所參考之數據流的壓縮選項。 此參數會與pavi配對。 參陣列可以重複為變數數目的自變數。

...

傳回值

如果成功或發生錯誤，則傳回AVIERR_OK。

言論

此函式會建立檔案、將數據流數據複製到檔案、關閉檔案，以及釋放新檔案所使用的資源。 此函式的最後兩個參數會識別要儲存在檔案中的數據流，並定義該數據流的壓縮選項。 在 AVI 檔案中儲存多個資料流時，請針對檔案中的每個資料流重複這兩個數據流特定參數。

回呼函式（使用 lpfnCallback參考）可以顯示狀態資訊，並讓使用者取消儲存作業。 回檔函式會使用下列格式：


LONG PASCAL SaveCallback(int nPercent)

nPercent 參數會指定儲存的檔案百分比。

如果使用者想要中止儲存作業，則回呼函式應該會傳回AVIERR_OK作業，並AVIERR_USERABORT。

pavi 自變數 是 IAVIStream 介面 指標。

注意

vfw.h 標頭會根據 UNICODE 預處理器常數的定義，將 AVISave 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 vfw.h
連結庫 Vfw32.lib
DLL Avifil32.dll

另請參閱

AVIFile 函式

AVIFile 函式和巨集