共用方式為

AVIStreamRead 函式 (vfw.h)

  • 發行項

AVIStreamRead 函式會根據數據流類型從數據流讀取音訊、視訊或其他數據。

語法

HRESULT AVIStreamRead(
  PAVISTREAM pavi,
  LONG       lStart,
  LONG       lSamples,
  LPVOID     lpBuffer,
  LONG       cbBuffer,
  LONG       *plBytes,
  LONG       *plSamples
);

參數

pavi

開啟數據流的句柄。

lStart

要讀取的第一個範例。

lSamples

要讀取的範例數目。 您也可以指定值AVISTREAMREAD_CONVENIENT，讓數據流處理程式決定要讀取的樣本數目。

lpBuffer

要包含數據的緩衝區指標。

cbBuffer

lpBuffer 所指向緩衝區的大小，以位元組為單位。

plBytes

緩衝區的指標，這個緩衝區會接收 lpBuffer 所參考之緩衝區中寫入的數據位元組數目。 此值可以是 NULL。

plSamples

緩衝區的指標，接收 lpBuffer 所參考之緩衝區中寫入的樣本數目。 此值可以是 NULL。

傳回值

如果成功或發生錯誤，則傳回零。 可能的錯誤值包括下列專案。

傳回碼 Description
AVIERR_BUFFERTOOSMALL
 緩衝區大小 cbBuffer 小於單一數據樣本。
AVIERR_MEMORY
 記憶體不足，無法完成讀取作業。
AVIERR_FILEREAD
 讀取檔案時發生磁碟錯誤。

備註

如果 lpBuffer 為 NULL，則此函式不會讀取任何數據;它會傳回要讀取之數據大小的相關信息。

自變數 pavi 是 IAVIStream 介面的指標。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 vfw.h
程式庫 Vfw32.lib
Dll Avifil32.dll

另請參閱

AVIFile 函式

AVIFile 函式和宏