Método IAVIStream::ReadFormat (vfw.h)
El método ReadFormat obtiene información de formato de una secuencia. Rellena y devuelve una estructura con los datos de 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 búfer de datos de formato. Se llama cuando una aplicación usa la función AVIStreamReadFormat .
Sintaxis
HRESULT ReadFormat(
LONG lPos,
LPVOID lpFormat,
LONG *lpcbFormat
);
Parámetros
lPos
Posición del ejemplo o marco.
lpFormat
Puntero al búfer para los datos de formato. Especifique NULL para solicitar el tamaño necesario del búfer.
lpcbFormat
Puntero a un búfer que recibe el tamaño, en bytes, del búfer especificado por lpFormat. Cuando se llama a este método, el contenido de este parámetro indica el tamaño del búfer especificado por lpFormat. Cuando este método devuelve el control a la aplicación, el contenido de este parámetro especifica la cantidad de datos leídos o el tamaño necesario del búfer.
Valor devuelto
Devuelve el VALOR HRESULT definido por OLE.
Comentarios
El tipo de datos almacenados en una secuencia dicta la información de formato y la estructura que contiene la información de formato. Un controlador de secuencias debe devolver toda la información de formato aplicable en esta estructura, incluida la información de paleta cuando el formato usa una paleta. Un controlador de flujo no debe devolver datos de flujo con la estructura .
Los controladores de secuencias de vídeo estándar proporcionan información de formato en una estructura BITMAPINFOHEADER . Los controladores de secuencias de audio estándar proporcionan información de formato en una estructura PCMWAVEFORMAT . Otros flujos de datos pueden usar otras estructuras que describen los datos del flujo.
Para los controladores escritos en C++, ReadFormat tiene la sintaxis siguiente:
HRESULT ReadFormat(LONG lPos, LPVOID lpFormat,
LONG *lpcbFormat)
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 |
Consulte también
Interfaces de controlador de Stream y archivos personalizados