Función AVIStreamFindSample (vfw.h)
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 |