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