IAVIStream：：ReadFormat 方法 (vfw.h)

ReadFormat 方法會從數據流取得格式資訊。填滿並傳回結構，其中包含應用程式定義緩衝區中的數據。如果未提供緩衝區，請決定擷取格式數據緩衝區所需的緩衝區大小。當應用程式使用 AVIStreamReadFormat 函式時呼叫。

語法

HRESULT ReadFormat(
  LONG   lPos,
  LPVOID lpFormat,
  LONG   *lpcbFormat
);

lPos

範例或框架的位置。

lpFormat

格式數據的緩衝區指標。指定 NULL 以要求緩衝區的必要大小。

lpcbFormat

緩衝區的指標，該緩衝區會接收 lpFormat 所指定的緩衝區大小，以位元組為單位。呼叫這個方法時，此參數的內容會指出 lpFormat 所指定的緩衝區大小。當這個方法將控制權傳回應用程式時，此參數的內容會指定讀取的數據量或緩衝區的必要大小。

傳回 OLE 所定義的 HRESULT。

儲存在數據流中的數據類型會指定格式資訊和包含格式信息的結構。數據流處理程式應該傳回此結構中的所有適用格式資訊，包括當格式使用調色盤時，包含調色盤資訊。數據流處理程式不應該傳回具有結構的數據流數據。

標準視訊數據流處理程式會在 BITMAPINFOHEADER 結構中提供格式資訊。標準音訊數據流處理程式會在 PCMWAVEFORMAT 結構中提供格式資訊。其他數據流可以使用描述數據流數據的其他結構。

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


HRESULT ReadFormat(LONG lPos, LPVOID lpFormat, 
    LONG *lpcbFormat)