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:
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:
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 |