AVISTREAMINFOA 結構（vfw.h）

發行項
11/20/2024

AVISTREAMINFO 結構包含單一數據流的資訊。

語法

typedef struct _AVISTREAMINFOA {
  DWORD fccType;
  DWORD fccHandler;
  DWORD dwFlags;
  DWORD dwCaps;
  WORD  wPriority;
  WORD  wLanguage;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwStart;
  DWORD dwLength;
  DWORD dwInitialFrames;
  DWORD dwSuggestedBufferSize;
  DWORD dwQuality;
  DWORD dwSampleSize;
  RECT  rcFrame;
  DWORD dwEditCount;
  DWORD dwFormatChangeCount;
  char  szName[64];
} AVISTREAMINFOA, *LPAVISTREAMINFOA;

成員

fccType

指出數據流類型的四個字元程式代碼。下列常數已針對 AVI 數據流中常用的數據定義：

不斷	描述
streamtypeAUDIO	表示音訊數據流。
streamtypeMIDI	表示 MIDI 數據流。
streamtypeTEXT	表示文字數據流。
streamtypeVIDEO	表示視訊串流。

fccHandler

壓縮器處理程式的四個字元程序代碼，會在儲存時壓縮此視訊串流（例如，mmioFOURCC （'M'，'S'，'V'，'C'））。這個成員不會用於音訊數據流。

dwFlags

數據流適用的旗標。這些旗標中高序字組的位是數據流中所含數據類型的特定位。定義下列旗標：

名字	描述
AVISTREAMINFO_DISABLED	表示當使用者明確啟用時，應該轉譯此數據流。
AVISTREAMINFO_FORMATCHANGES	表示此影片串流包含調色盤變更。此旗標會警告播放軟體需要讓調色盤產生動畫效果。

dwCaps

功能旗標;目前未使用。

wPriority

數據流的優先順序。

wLanguage

數據流的語言。

dwScale

適用於數據流的時間刻度。將 dwRate 除以 dwScale 可提供每秒樣本數目的播放速率。

針對視訊串流，此速率應該是幀速率。對於音訊串流，此速率應對應到音訊區塊大小（nBlockAlignWAVEAT 或 PCMWAVEFORMAT 結構的成員），而 PCM （Pulse Code Fm）音訊會降低到取樣率。

dwRate

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

dwStart

AVI 檔案第一個框架的範例編號。這些單位是由 dwRate 和 dwScale所定義。一般而言，這是零，但可以指定不會與檔案同時啟動之數據流的延遲時間。

1.0 版的 AVI 工具不支援非零開始時間。

dwLength

此數據流的長度。這些單位是由 dwRate 和 dwScale所定義。

dwInitialFrames

音訊扭曲。這個成員會指定在交錯的檔案中的視訊畫面之前扭曲音訊數據多少。一般而言，這大約是0.75秒。

dwSuggestedBufferSize

數據流的建議緩衝區大小，以位元組為單位。一般而言，這個成員包含對應至數據流中最大區塊的值。使用正確的緩衝區大小可讓播放更有效率。如果您不知道正確的緩衝區大小，請使用零。

dwQuality

數據流中影片數據的質量指標。品質會以介於 0 到 10,000 之間的數位表示。對於壓縮的數據，這通常代表傳遞至壓縮軟體的質量參數值。如果設定為 –1，驅動程式會使用預設品質值。

dwSampleSize

單一數據範例的大小，以位元組為單位。如果這個成員的值是零，樣本的大小可能會有所不同，而且每個數據樣本（例如視訊畫面）都必須位於不同的區塊中。非零值表示多個數據樣本可以分組成檔案內的單一區塊。

對於視訊串流，這個數位通常是零，但如果所有視訊畫面的大小都相同，則可能是非零。對於音訊串流，此數字應該與描述音訊之的的 nBlockAlign 成員相同，或的 NMATEX 結構。

rcFrame

影片目的地矩形的維度。這些值代表左上角、高度和矩形寬度的座標。

dwEditCount

已編輯數據流的次數。數據流處理程式會維護此計數。

dwFormatChangeCount

數據流格式已變更的次數。數據流處理程式會維護此計數。

szName[64]

包含數據流描述的 Null 終止字串。

言論

注意

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

要求

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