Función acmStreamSize (msacm.h)

La función acmStreamSize devuelve un tamaño recomendado para un búfer de origen o destino en una secuencia de ACM.

Sintaxis

MMRESULT ACMAPI acmStreamSize(
  HACMSTREAM has,
  DWORD      cbInput,
  LPDWORD    pdwOutputBytes,
  DWORD      fdwSize
);

Parámetros

has

Identificador del flujo de conversión.

cbInput

Tamaño, en bytes, del búfer de origen o destino. Las marcas fdwSize especifican lo que define el parámetro de entrada. Este parámetro debe ser distinto de cero.

pdwOutputBytes

Puntero a una variable que contiene el tamaño, en bytes, del búfer de origen o de destino. Las marcas fdwSize especifican lo que define el parámetro de salida. Si la función acmStreamSize se realiza correctamente, esta ubicación siempre se rellenará con un valor distinto de cero.

fdwSize

Marcas para la consulta de tamaño de secuencia. Se definen los valores siguientes:

Valor	Significado
ACM_STREAMSIZEF_DESTINATION	El parámetro cbInput contiene el tamaño del búfer de destino. El parámetro pdwOutputBytes recibirá el tamaño de búfer de origen recomendado, en bytes.
ACM_STREAMSIZEF_SOURCE	El parámetro cbInput contiene el tamaño del búfer de origen. El parámetro pdwOutputBytes recibirá el tamaño de búfer de destino recomendado, en bytes.

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto	Descripción
ACMERR_NOTPOSSIBLE	No se puede realizar la operación solicitada.
MMSYSERR_INVALFLAG	Al menos una marca no es válida.
MMSYSERR_INVALHANDLE	El identificador especificado no es válido.
MMSYSERR_INVALPARAM	Al menos un parámetro no es válido.

Comentarios

Una aplicación puede usar esta función para determinar los tamaños de búfer sugeridos para los búferes de origen o de destino. Los tamaños de búfer devueltos pueden ser solo una estimación de los tamaños reales necesarios para la conversión. Dado que los tamaños de conversión reales no siempre se pueden determinar sin realizar la conversión, los tamaños devueltos normalmente se sobrestimarán.

En caso de error, la ubicación a la que apunta pdwOutputBytes recibirá cero. Esto supone que el puntero especificado por pdwOutputBytes es válido.

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	msacm.h
Library	Msacm32.lib
Archivo DLL	Msacm32.dll

Consulte también

Funciones de compresión de audio

Administrador de compresión de audio