Compartir a través de

Función acmStreamSize (msacm.h)

  • Artículo

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