aviStreamFindSample 函数 (vfw.h)

AVIStreamFindSample 函数返回样本 (关键帧、非空帧或包含相对于指定位置的格式更改) 帧的位置。

此函数取代了过时的 AVIStreamFindKeyFrame 函数。

语法

LONG AVIStreamFindSample(
  PAVISTREAM pavi,
  LONG       lPos,
  LONG       lFlags
);

pavi

打开流的句柄。

lPos

搜索的起始帧。

lFlags

指定要定位的帧类型、要搜索的流中的方向以及返回信息类型的标志。定义了以下标志。

值	含义
FIND_ANY	查找非空帧。此标志取代SEARCH_ANY标志。
FIND_KEY	查找关键帧。此标志取代SEARCH_KEY标志。
FIND_FORMAT	查找格式更改。
FIND_NEXT	查找最近的样本、帧或格式更改向前搜索。当前示例包含在搜索中。将此标志与 FIND_ANY、FIND_KEY 或 FIND_FORMAT 标志一起使用。此标志取代SEARCH_FORWARD标志。
FIND_PREV	查找最近的样本、帧或格式更改向后搜索。当前示例包含在搜索中。将此标志与 FIND_ANY、FIND_KEY 或 FIND_FORMAT 标志一起使用。此标志取代SEARCH_NEAREST和SEARCH_BACKWARD标志。
FIND_FROM_START	查找从流开头开始的第一个样本、帧或格式更改。将此标志与 FIND_ANY、FIND_KEY 或 FIND_FORMAT 标志一起使用。

返回找到的帧的位置;如果搜索不成功，则返回 -1。

FIND_KEY、FIND_ANY和FIND_FORMAT标志是互斥的，FIND_NEXT标志和FIND_PREV标志也是互斥的。

参数 pavi 包含指向 IAVIStream 接口的指针。


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