AVISTREAMINFOW 結構 (vfw.h)

  • 發行項

AVISTREAMINFO結構包含單一資料流程的資訊。

語法

typedef struct _AVISTREAMINFOW {
  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;
  WCHAR szName[64];
} AVISTREAMINFOW, *LPAVISTREAMINFOW;

成員

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