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)

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	vfw.h
Library	Vfw32.lib