Share via

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

  • Artículo

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

Controladores de archivos y Stream personalizados