IAVIStream：：Read 方法 (vfw.h)

Read方法會從資料流程讀取資料，並將它複製到應用程式定義的緩衝區。如果未提供緩衝區，它會決定擷取下一個資料緩衝區所需的緩衝區大小。當應用程式使用 AVIStreamRead 函式時呼叫。

語法

HRESULT Read(
  LONG   lStart,
  LONG   lSamples,
  LPVOID lpBuffer,
  LONG   cbBuffer,
  LONG   *plBytes,
  LONG   *plSamples
);

lStart

要讀取的範例或框架編號。

lSamples

要讀取的範例數目。

lpBuffer

要包含資料流程資料的應用程式定義緩衝區指標。您也可以指定 Null 來要求緩衝區的必要大小。許多應用程式會在每個讀取作業前面加上緩衝區大小的查詢，以查看需要緩衝區的大小。

cbBuffer

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

plBytes

接收讀取位元組數目的緩衝區指標。

plSamples

接收讀取樣本數目的緩衝區指標。

如果緩衝區不夠大，則傳回AVIERR_OK如果緩衝區不夠大而無法保存資料，則傳回AVIERR_BUFFERTOOSMALL。如果成功， Read 也會傳回資料緩衝區，其中包含緩衝區中 () ) 的畫面格數目或所需的緩衝區大小，以位元組為單位。

針對以 C++ 撰寫的處理常式， Read 具有下列語法：


HRESULT Read(LONG lStart, LONG lSamples, 
    LPVOID lpBuffer, LONG cbBuffer, 
    LONG *plBytes, LONG *plSamples);