Поделиться через


Функция 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
Header vfw.h
Библиотека Vfw32.lib
DLL Avifil32.dll

См. также раздел

Функции AVIFile

Функции и макросы AVIFile