AVIFileOpenW 函式（vfw.h）

AVIFileOpen 函式會開啟 AVI 檔案，並傳回用來存取它的檔案介面位址。 AVIFile 連結庫會維護開啟檔案的次數，但不會維護其發行次數。使用 AVIFileRelease 函式來釋放檔案並遞減計數。

語法

HRESULT AVIFileOpenW(
  PAVIFILE *ppfile,
  LPCWSTR  szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

ppfile

接收新 IAVIFile 介面指標之緩衝區的指標。

szFile

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

uMode

開啟檔案時要使用的存取模式。默認存取模式為OF_READ。您可以使用 AVIFileOpen來指定下列存取模式。

價值	意義
OF_CREATE	建立新的檔案。如果檔案已經存在，則會截斷為零長度。
OF_PARSE	略過耗時的作業，例如建置索引。如果您想要讓函式儘快傳回，請設定此旗標，例如，如果您要查詢檔案屬性，但不要讀取檔案。
OF_READ	開啟檔案以供讀取。
OF_READWRITE	開啟檔案以供讀取和寫入。
OF_SHARE_DENY_NONE	以非公開方式開啟檔案。其他進程可以開啟具有讀取或寫入存取權的檔案。如果另一個進程以相容性模式開啟檔案，AVIFileOpen 會失敗。
OF_SHARE_DENY_READ	以非公開方式開啟檔案。其他進程可以開啟具有寫入存取權的檔案。 AVIFileOpen 如果另一個進程以相容性模式開啟檔案或具有讀取許可權，就會失敗。
OF_SHARE_DENY_WRITE	以非公開方式開啟檔案。其他進程可以開啟具有讀取許可權的檔案。 AVIFileOpen 如果另一個進程以相容性模式開啟檔案或具有寫入許可權，就會失敗。
OF_SHARE_EXCLUSIVE	開啟檔案，並拒絕其他進程任何存取檔案。如果任何其他進程已開啟檔案，AVIFileOpen 會失敗。
OF_WRITE	開啟檔案以進行寫入。

lpHandler

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

如果成功或發生錯誤，則傳回零。可能的錯誤值包括下列專案。

傳回碼	描述
AVIERR_BADFORMAT	無法讀取檔案，指出損毀的檔案或無法辨識的格式。
AVIERR_MEMORY	因為記憶體不足，所以無法開啟檔案。
AVIERR_FILEREAD	讀取檔案時發生磁碟錯誤。
AVIERR_FILEOPEN	開啟檔案時發生磁碟錯誤。
REGDB_E_CLASSNOTREG	根據登錄，AVIFileOpen 中指定的檔類型沒有處理它的處理程式。

注意

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

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