Método IAVIStream::Read (vfw.h)

El método Read lee los datos de una secuencia y los copia en un búfer definido por la aplicación. Si no se proporciona ningún búfer, determina el tamaño del búfer necesario para recuperar el siguiente búfer de datos. Se llama cuando una aplicación usa la función AVIStreamRead .

Sintaxis

HRESULT Read(
  LONG   lStart,
  LONG   lSamples,
  LPVOID lpBuffer,
  LONG   cbBuffer,
  LONG   *plBytes,
  LONG   *plSamples
);

Parámetros

lStart

Iniciar el número de ejemplo o marco que se va a leer.

lSamples

Número de muestras que se van a leer.

lpBuffer

Puntero al búfer definido por la aplicación para contener los datos del flujo. También puede especificar NULL para solicitar el tamaño necesario del búfer. Muchas aplicaciones preceden a cada operación de lectura con una consulta para el tamaño del búfer para ver cómo se necesita un búfer.

cbBuffer

Tamaño, en bytes, del búfer especificado por lpBuffer.

plBytes

Puntero a un búfer que recibe el número de bytes leídos.

plSamples

Puntero a un búfer que recibe el número de muestras leídas.

Valor devuelto

Devuelve AVIERR_OK si se realiza correctamente o AVIERR_BUFFERTOOSMALL si el búfer no es lo suficientemente grande como para contener los datos. Si se ejecuta correctamente, Read también devuelve un búfer de datos con el número de fotogramas (muestras) incluidos en el búfer o el tamaño de búfer necesario, en bytes.

Comentarios

Para los controladores escritos en C++, Read tiene la sintaxis siguiente:

HRESULT Read(LONG lStart, LONG lSamples, 
    LPVOID lpBuffer, LONG cbBuffer, 
    LONG *plBytes, LONG *plSamples); 
 

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

Consulte también

Interfaces de controlador de secuencias y archivos personalizados

Controladores de archivos y secuencias personalizados