Estructura AVIFILEINFOA (vfw.h)

La estructura AVIFILEINFO contiene información global para un archivo AVI completo.

Sintaxis

typedef struct _AVIFILEINFOA {
  DWORD dwMaxBytesPerSec;
  DWORD dwFlags;
  DWORD dwCaps;
  DWORD dwStreams;
  DWORD dwSuggestedBufferSize;
  DWORD dwWidth;
  DWORD dwHeight;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwLength;
  DWORD dwEditCount;
  char  szFileType[64];
} AVIFILEINFOA, *LPAVIFILEINFOA;

Miembros

dwMaxBytesPerSec

Velocidad de datos máxima aproximada del archivo AVI.

dwFlags

Un OR bit a bit de cero o más marcas. Se definen las marcas siguientes:

Nombre	Descripción
AVIFILEINFO_HASINDEX	El archivo AVI tiene un índice al final del archivo. Para un buen rendimiento, todos los archivos AVI deben contener un índice.
AVIFILEINFO_MUSTUSEINDEX	El índice de archivo contiene el orden de reproducción de los fragmentos del archivo. Use el índice en lugar de la ordenación física de los fragmentos al reproducir los datos. Esto puede usarse para crear una lista de fotogramas para su edición.
AVIFILEINFO_ISINTERLEAVED	El archivo AVI está intercalado.
AVIFILEINFO_WASCAPTUREFILE	El archivo AVI es un archivo especialmente asignado que se usa para capturar vídeo en tiempo real. Las aplicaciones deben advertir al usuario antes de escribir sobre un archivo con este conjunto de marcas porque probablemente el usuario desfragmentó este archivo.
AVIFILEINFO_COPYRIGHTED	El archivo AVI contiene datos y software protegidos por derechos de autor. Cuando se usa esta marca, el software no debe permitir que los datos se dupliquen.

dwCaps

Marcas de funcionalidad. Se definen las marcas siguientes:

Nombre	Descripción
AVIFILECAPS_CANREAD	Una aplicación puede abrir el archivo AVI con el privilegio de lectura.
AVIFILECAPS_CANWRITE	Una aplicación puede abrir el archivo AVI con el privilegio de escritura.
AVIFILECAPS_ALLKEYFRAMES	Cada fotograma del archivo AVI es un fotograma clave.
AVIFILECAPS_NOCOMPRESSION	El archivo AVI no usa un método de compresión.

dwStreams

Número de secuencias del archivo. Por ejemplo, un archivo con audio y vídeo tiene al menos dos secuencias.

dwSuggestedBufferSize

Tamaño de búfer sugerido, en bytes, para leer el archivo. Por lo general, este tamaño debe ser lo suficientemente grande como para contener el fragmento más grande del archivo. Para un archivo intercalado, este tamaño debe ser lo suficientemente grande como para leer un registro completo, no solo un fragmento.

Si el tamaño del búfer es demasiado pequeño o se establece en cero, el software de reproducción tendrá que reasignar la memoria durante la reproducción, lo que reduce el rendimiento.

dwWidth

Ancho, en píxeles, del archivo AVI.

dwHeight

Alto, en píxeles, del archivo AVI.

dwScale

Escala de tiempo aplicable a todo el archivo. Dividir dwRate por dwScale proporciona el número de muestras por segundo.

Cualquier secuencia puede definir su propia escala de tiempo para reemplazar la escala de tiempo del archivo.

dwRate

Velocidad en un formato entero. Para obtener la tasa de muestras por segundo, divida este valor por el valor de dwScale.

dwLength

Longitud del archivo AVI. Las unidades se definen mediante dwRate y dwScale.

dwEditCount

Número de secuencias agregadas o eliminadas del archivo AVI.

szFileType[64]

Cadena terminada en NULL que contiene información descriptiva para el tipo de archivo.

Observaciones

Nota

El encabezado vfw.h define AVIFILEINFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	vfw.h

Consulte también

funciones y macros AVIFile

de estructuras AVIFile