AVIStreamOpenFromFileA 函式 (vfw.h)

AVIStreamOpenFromFile 函式會從檔案開啟單一數據流。

語法

HRESULT AVIStreamOpenFromFileA(
  PAVISTREAM *ppavi,
  LPCSTR     szFile,
  DWORD      fccType,
  LONG       lParam,
  UINT       mode,
  CLSID      *pclsidHandler
);

參數

ppavi

接收新數據流句柄之緩衝區的指標。

szFile

包含要開啟之檔名的 Null 終止字串。

fccType

四個字元的程式代碼，指出要開啟的數據流類型。 零表示任何數據流都可以開啟。 下列定義適用於 AVI 資料流中常見的資料：

值	Description
streamtypeAUDIO	表示音訊數據流。
streamtypeMIDI	表示 MIDI 數據流。
streamtypeTEXT	表示文字數據流。
streamtypeVIDEO	表示視訊串流。

lParam

Stream 在 Stream 指定於 Stream，以存取該類型。 此參數是以零起始;使用零來指定第一個出現專案。

mode

開啟檔案時要使用的存取模式。 此函式只能開啟現有的數據流，因此無法使用OF_CREATE模式旗標。 如需 mode 參數可用旗標的詳細資訊，請參閱 OpenFile函 式。

pclsidHandler

您想要使用之處理程式之類別識別碼的指標。 如果值為 NULL，系統會根據擴展名或檔案 RIFF 類型，從登錄中選擇一個。

傳回值

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

備註

此函式會呼叫 AVIFileOpen、 AVIFileGetStream 和 AVIFileRelease 函式。

注意

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

規格需求

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

另請參閱

AVIFile 函式

AVIFile 函式和宏