AVIFILEINFOA 結構 (vfw.h)

  • 發行項

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

語法

typedef struct _AVIFILEINFOA {
  DWORD dwMaxBytesPerSec;
  DWORD dwFlags;
  DWORD dwCaps;
  DWORD dwStreams;
  DWORD dwSuggestedBufferSize;
  DWORD dwWidth;
  DWORD dwHeight;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwLength;
  DWORD dwEditCount;
  char  szFileType[64];
} AVIFILEINFOA, *LPAVIFILEINFOA;

成員

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 檔案的長度。 單位是由 dwRate 和 dwScale所定義。

dwEditCount

已新增或刪除 AVI 檔案的資料流程數目。

szFileType[64]

以 Null 結尾的字串，其中包含檔案類型的描述性資訊。

備註

注意

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

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 vfw.h

另請參閱

AVIFile 函式和宏

AVIFile 結構