Função acmStreamSize (msacm.h)

A função acmStreamSize retorna um tamanho recomendado para um buffer de origem ou de destino em um fluxo do ACM.

Sintaxe

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

Parâmetros

has

Manipule para o fluxo de conversão.

cbInput

Tamanho, em bytes, do buffer de origem ou destino. Os sinalizadores fdwSize especificam o que o parâmetro de entrada define. Esse parâmetro deve ser diferente de zero.

pdwOutputBytes

Ponteiro para uma variável que contém o tamanho, em bytes, do buffer de origem ou de destino. Os sinalizadores fdwSize especificam o que o parâmetro de saída define. Se a função acmStreamSize for bem-sucedida, esse local sempre será preenchido com um valor diferente de zero.

fdwSize

Sinalizadores para a consulta de tamanho do fluxo. Os seguintes valores são definidos:

Valor	Significado
ACM_STREAMSIZEF_DESTINATION	O parâmetro cbInput contém o tamanho do buffer de destino. O parâmetro pdwOutputBytes receberá o tamanho do buffer de origem recomendado, em bytes.
ACM_STREAMSIZEF_SOURCE	O parâmetro cbInput contém o tamanho do buffer de origem. O parâmetro pdwOutputBytes receberá o tamanho do buffer de destino recomendado, em bytes.

Retornar valor

Retornará zero se tiver êxito ou um erro, caso contrário. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
ACMERR_NOTPOSSIBLE	A operação solicitada não pode ser executada.
MMSYSERR_INVALFLAG	Pelo menos um sinalizador é inválido.
MMSYSERR_INVALHANDLE	O identificador especificado é inválido.
MMSYSERR_INVALPARAM	Pelo menos um parâmetro é inválido.

Comentários

Um aplicativo pode usar essa função para determinar os tamanhos de buffer sugeridos para buffers de origem ou de destino. Os tamanhos de buffer retornados podem ser apenas uma estimativa dos tamanhos reais necessários para conversão. Como os tamanhos reais de conversão nem sempre podem ser determinados sem executar a conversão, os tamanhos retornados geralmente serão superestimados.

No caso de um erro, o local apontado por pdwOutputBytes receberá zero. Isso pressupõe que o ponteiro especificado por pdwOutputBytes seja válido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msacm.h
Biblioteca	Msacm32.lib
DLL	Msacm32.dll

Confira também

Funções de compactação de áudio

Gerenciador de Compactação de Áudio