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 |