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

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	vfw.h
程式庫	Vfw32.lib
Dll	Avifil32.dll

另請參閱

AVIFile 函式

AVIFile 函式和宏