Compartir a través de


Estructura AVISTREAMINFOA (vfw.h)

La estructura AVISTREAMINFO contiene información para una sola secuencia.

Sintaxis

typedef struct _AVISTREAMINFOA {
  DWORD fccType;
  DWORD fccHandler;
  DWORD dwFlags;
  DWORD dwCaps;
  WORD  wPriority;
  WORD  wLanguage;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwStart;
  DWORD dwLength;
  DWORD dwInitialFrames;
  DWORD dwSuggestedBufferSize;
  DWORD dwQuality;
  DWORD dwSampleSize;
  RECT  rcFrame;
  DWORD dwEditCount;
  DWORD dwFormatChangeCount;
  char  szName[64];
} AVISTREAMINFOA, *LPAVISTREAMINFOA;

Miembros

fccType

Código de cuatro caracteres que indica el tipo de secuencia. Se han definido las siguientes constantes para los datos que se encuentran habitualmente en secuencias AVI:

Constante Descripción
streamtypeAUDIO
Indica una secuencia de audio.
streamtypeMIDI
Indica una secuencia MIDI.
streamtypeTEXT
Indica una secuencia de texto.
streamtypeVIDEO
Indica una secuencia de vídeo.

fccHandler

Código de cuatro caracteres del controlador de compresor que comprimirá esta secuencia de vídeo cuando se guarde (por ejemplo, mmioFOURCC ('M','S','V','C')). Este miembro no se usa para secuencias de audio.

dwFlags

Marcas aplicables para la secuencia. Los bits de la palabra de orden alto de estas marcas son específicos del tipo de datos contenidos en la secuencia. Se definen las marcas siguientes:

Nombre Descripción
AVISTREAMINFO_DISABLED
Indica que este flujo debe representarse cuando el usuario lo habilite explícitamente.
AVISTREAMINFO_FORMATCHANGES
Indica que esta secuencia de vídeo contiene cambios de paleta. Esta marca advierte al software de reproducción que tendrá que animar la paleta.

dwCaps

Marcas de funcionalidad; actualmente no se está usando.

wPriority

Prioridad de la secuencia.

wLanguage

Idioma de la secuencia.

dwScale

Escala de tiempo aplicable a la secuencia. Dividir dwRate por dwScale proporciona la velocidad de reproducción en el número de muestras por segundo.

En el caso de las secuencias de vídeo, esta velocidad debe ser la velocidad de fotogramas. En el caso de las secuencias de audio, esta velocidad debe corresponder al tamaño del bloque de audio (el miembro nBlockAlign de la estructura WAVEFORMAT o PCMWAVEFORMAT ), que para el audio PCM (Modulación de código de pulso) se reduce a la frecuencia de muestreo.

dwRate

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

dwStart

Número de ejemplo del primer marco del archivo AVI. Las unidades se definen mediante dwRate y dwScale. Normalmente, es cero, pero puede especificar un tiempo de retraso para una secuencia que no se inicia simultáneamente con el archivo.

La versión 1.0 de las herramientas avi no admite una hora de inicio distinta de cero.

dwLength

Longitud de esta secuencia. Las unidades se definen mediante dwRate y dwScale.

dwInitialFrames

Asimetría de audio. Este miembro especifica cuánto se asimetrían los datos de audio por delante de los fotogramas de vídeo en archivos intercalados. Normalmente, esto es de aproximadamente 0,75 segundos.

dwSuggestedBufferSize

Tamaño de búfer recomendado, en bytes, para la secuencia. Normalmente, este miembro contiene un valor correspondiente al fragmento más grande de la secuencia. El uso del tamaño correcto del búfer hace que la reproducción sea más eficaz. Use cero si no conoce el tamaño correcto del búfer.

dwQuality

Indicador de calidad de los datos de vídeo en la secuencia. La calidad se representa como un número comprendido entre 0 y 10 000. En el caso de los datos comprimidos, normalmente representa el valor del parámetro de calidad pasado al software de compresión. Si se establece en –1, los controladores usan el valor de calidad predeterminado.

dwSampleSize

Tamaño, en bytes, de una sola muestra de datos. Si el valor de este miembro es cero, las muestras pueden variar en tamaño y cada muestra de datos (por ejemplo, un fotograma de vídeo) debe estar en un fragmento independiente. Un valor distinto de cero indica que se pueden agrupar varias muestras de datos en un único fragmento dentro del archivo.

En el caso de las secuencias de vídeo, este número suele ser cero, aunque puede ser distinto de cero si todos los fotogramas de vídeo tienen el mismo tamaño. Para las secuencias de audio, este número debe ser el mismo que el miembro nBlockAlign de la estructura WAVEFORMAT o WAVEFORMATEX que describe el audio.

rcFrame

Dimensiones del rectángulo de destino de vídeo. Los valores representan las coordenadas de la esquina superior izquierda, el alto y el ancho del rectángulo.

dwEditCount

Número de veces que se ha editado la secuencia. El controlador de secuencia mantiene este recuento.

dwFormatChangeCount

Número de veces que ha cambiado el formato de secuencia. El controlador de secuencia mantiene este recuento.

szName[64]

Cadena terminada en NULL que contiene una descripción de la secuencia.

Comentarios

Nota

El encabezado vfw.h define AVISTREAMINFO 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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]
Encabezado vfw.h

Consulte también

Funciones y macros AVIFile

Estructuras AVIFile

PCMWAVEFORMAT

WAVEFORMAT

WAVEFORMATEX

mmioFOURCC