AVISTREAMINFOA 結構 (vfw.h)

  • 發行項

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 可提供每秒樣本數目的播放速率。

對於視訊串流，此速率應該是幀速率。 對於音訊串流，此速率應該對應至 (將 PCM 或 PCMWAVEFORMAT 結構) nBlockAlign 成員的音頻區塊大小對應，而 PCM (Pulse Code Audio) 音頻會縮減為取樣速率。

dwRate

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

dwStart

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

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

dwLength

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

dwInitialFrames

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

dwSuggestedBufferSize

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

dwQuality

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

dwSampleSize

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

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

rcFrame

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

dwEditCount

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

dwFormatChangeCount

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

szName[64]

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

備註

注意

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

規格需求

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

另請參閱

AVIFile 函式和宏

AVIFile 結構

PCMWAVEFORMAT

波道

波擷取

mmioFOURCC