共用方式為


Vfw.h) (AVIFILEINFOW 結構

AVIFILEINFO 結構包含整個 AVI 檔案的全域資訊。

語法

typedef struct _AVIFILEINFOW {
  DWORD dwMaxBytesPerSec;
  DWORD dwFlags;
  DWORD dwCaps;
  DWORD dwStreams;
  DWORD dwSuggestedBufferSize;
  DWORD dwWidth;
  DWORD dwHeight;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwLength;
  DWORD dwEditCount;
  WCHAR szFileType[64];
} AVIFILEINFOW, *LPAVIFILEINFOW;

成員

dwMaxBytesPerSec

AVI 檔案的近似最大數據速率。

dwFlags

零個或多個旗標的位 OR 。 已定義下列旗標:

名稱 描述
AVIFILEINFO_HASINDEX
AVI 檔案在檔案結尾處有索引。 為了達到良好的效能,所有 AVI 檔案都應該包含索引。
AVIFILEINFO_MUSTUSEINDEX
檔案索引包含檔案中區塊的播放順序。 播放數據時,請使用索引,而不是區塊的實體順序。 這可用來建立框架清單以進行編輯。
AVIFILEINFO_ISINTERLEAVED
AVI 檔案交錯。
AVIFILEINFO_WASCAPTUREFILE
AVI 檔案是特別配置的檔案,用於擷取實時視訊。 應用程式應該在寫入已設定此旗標的檔案之前警告使用者,因為使用者可能已重組此檔案。
AVIFILEINFO_COPYRIGHTED
AVI 檔案包含著作權數據和軟體。 使用此旗標時,軟體不應允許複製數據。

dwCaps

功能旗標。 已定義下列旗標:

名稱 描述
AVIFILECAPS_CANREAD
應用程式可以使用讀取許可權開啟 AVI 檔案。
AVIFILECAPS_CANWRITE
應用程式可以使用寫入許可權開啟 AVI 檔案。
AVIFILECAPS_ALLKEYFRAMES
AVI 檔案中的每個畫面都是主要畫面格。
AVIFILECAPS_NOCOMPRESSION
AVI 檔案不使用壓縮方法。

dwStreams

檔案中的數據流數目。 例如,具有音訊和視訊的檔案至少有兩個數據流。

dwSuggestedBufferSize

用於讀取檔案的建議緩衝區大小,以位元組為單位。 一般而言,此大小應該夠大,以在檔案中包含最大的區塊。 對於交錯的檔案,此大小應該夠大,足以讀取整個記錄,而不只是區塊。

如果緩衝區大小太小或設定為零,則播放軟體必須在播放期間重新配置記憶體,以減少效能。

dwWidth

AVI 檔案的寬度,以像素為單位。

dwHeight

AVI 檔案的高度,以像素為單位。

dwScale

適用於整個檔案的時間調整。 將 dwRate 除以 dwScale 會提供每秒樣本數目。

任何數據流都可以定義自己的時間調整,以取代檔案時間調整。

dwRate

整數格式的速率。 若要取得每秒樣本中的速率,請將此值除以 dwScale 中的值。

dwLength

AVI 檔案的長度。 單位是由 dwRatedwScale 所定義。

dwEditCount

已新增或刪除 AVI 檔案的數據流數目。

szFileType[64]

以 Null 結束的字串,其中包含文件類型的描述性資訊。

備註

注意

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

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 vfw.h

另請參閱

AVIFile 函式和宏

AVIFile 結構