AVIFileOpen 函式 (vfw.h)

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

語法

HRESULT AVIFileOpen(
  PAVIFILE *ppfile,
  LPCSTR   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 中指定的檔案類型沒有處理它的處理常式。


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