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 數據流中常見的數據定義下列常數:
常數 | 描述 |
---|---|
|
表示音訊數據流。 |
|
表示 MIDI 數據流。 |
|
表示文字數據流。 |
|
表示視訊串流。 |
fccHandler
壓縮處理程式的四個字元程序代碼,會在儲存 (時壓縮此視訊串流,例如 mmioFOURCC ('M','S','V','C') ) 。 這個成員不會用於音訊數據流。
dwFlags
數據流適用的旗標。 這些旗標之高序字中的位是數據流中所含數據類型特有的。 定義下列旗標:
名稱 | 描述 |
---|---|
|
指出當使用者明確啟用時,應該轉譯此數據流。 |
|
指出此視訊串流包含調色盤變更。 此旗標會警告播放軟體,使其需要讓調色盤產生動畫效果。 |
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 |