Compartir a través de

Función AVIStreamRead (vfw.h)

  • Artículo

La función AVIStreamRead lee audio, vídeo u otros datos de una secuencia según el tipo de secuencia.

Sintaxis

HRESULT AVIStreamRead(
  PAVISTREAM pavi,
  LONG       lStart,
  LONG       lSamples,
  LPVOID     lpBuffer,
  LONG       cbBuffer,
  LONG       *plBytes,
  LONG       *plSamples
);

Parámetros

pavi

Identificador de una secuencia abierta.

lStart

Primer ejemplo que se va a leer.

lSamples

Número de muestras que se van a leer. También puede especificar el valor AVISTREAMREAD_CONVENIENT para permitir que el controlador de secuencia determine el número de muestras que se van a leer.

lpBuffer

Puntero a un búfer que contiene los datos.

cbBuffer

Tamaño, en bytes, del búfer al que apunta lpBuffer.

plBytes

Puntero a un búfer que recibe el número de bytes de datos escritos en el búfer al que hace referencia lpBuffer. Este valor puede ser NULL.

plSamples

Puntero a un búfer que recibe el número de muestras escritas en el búfer al que hace referencia lpBuffer. Este valor puede ser NULL.

Valor devuelto

Devuelve cero si es correcto o si se produce un error de lo contrario. Entre los posibles valores de error se incluyen los siguientes.

Código devuelto Descripción
AVIERR_BUFFERTOOSMALL
 El tamaño del búfer cbBuffer era menor que una única muestra de datos.
AVIERR_MEMORY
 No había suficiente memoria para completar la operación de lectura.
AVIERR_FILEREAD
 Error de disco al leer el archivo.

Comentarios

Si lpBuffer es NULL, esta función no lee ningún dato; devuelve información sobre el tamaño de los datos que se leerían.

El argumento pavi es un puntero a una interfaz IAVIStream .

Requisitos

Requisito Value
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