Función AVIStreamFindSample (vfw.h)

  • Artículo

La función AVIStreamFindSample devuelve la posición de una muestra (fotograma clave, marco no vacío o marco que contiene un cambio de formato) en relación con la posición especificada.

Esta función sustituye a la función AVIStreamFindKeyFrame obsoleta.

Sintaxis

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

Parámetros

pavi

Identificador de una secuencia abierta.

lPos

Marco inicial de la búsqueda.

lFlags

Marcas que designan el tipo de marco que se va a buscar, la dirección de la secuencia que se va a buscar y el tipo de información de devolución. Se definen las marcas siguientes.

Valor Significado
FIND_ANY Busca un marco no vacío. Esta marca sustituye a la marca SEARCH_ANY.
FIND_KEY Busca un fotograma clave. Esta marca sustituye a la marca SEARCH_KEY.
FIND_FORMAT Busca un cambio de formato.
FIND_NEXT Busca el ejemplo, marco o cambio de formato más cercano en la búsqueda hacia delante. El ejemplo actual se incluye en la búsqueda. Use esta marca con la marca FIND_ANY, FIND_KEY o FIND_FORMAT. Esta marca sustituye a la marca SEARCH_FORWARD.
FIND_PREV Busca el ejemplo, el marco o el formato más cercanos para cambiar la búsqueda hacia atrás. El ejemplo actual se incluye en la búsqueda. Use esta marca con la marca FIND_ANY, FIND_KEY o FIND_FORMAT. Esta marca reemplaza las marcas SEARCH_NEAREST y SEARCH_BACKWARD.
FIND_FROM_START Busca el primer cambio de ejemplo, marco o formato a partir del principio de la secuencia. Use esta marca con la marca FIND_ANY, FIND_KEY o FIND_FORMAT.

Valor devuelto

Devuelve la posición del marco encontrado o -1 si la búsqueda no se realiza correctamente.

Comentarios

Las marcas FIND_KEY, FIND_ANY y FIND_FORMAT son mutuamente excluyentes, al igual que las marcas FIND_NEXT y FIND_PREV.

El argumento pavi contiene un puntero a una interfaz IAVIStream .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vfw.h
Library Vfw32.lib
Archivo DLL Avifil32.dll

Consulte también

Funciones AVIFile

Funciones y macros AVIFile