Função acmFormatSuggest (msacm.h)

Artigo
08/24/2023

A função acmFormatSuggest consulta o ACM ou um driver ACM especificado para sugerir um formato de destino para o formato de origem fornecido. Por exemplo, um aplicativo pode usar essa função para determinar um ou mais formatos PCM válidos para os quais um formato compactado pode ser descompactado.

Sintaxe

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

Parâmetros

had

Manipule para uma instância aberta de um driver para consultar um formato de destino sugerido. Se esse parâmetro for NULL, o ACM tentará encontrar o melhor driver para sugerir um formato de destino.

pwfxSrc

Ponteiro para uma estrutura WAVEFORMATEX que identifica o formato de origem para o qual um formato de destino será sugerido pelo ACM ou pelo driver especificado.

pwfxDst

Ponteiro para uma estrutura WAVEFORMATEX que receberá o formato de destino sugerido para o formato pwfxSrc . Dependendo do parâmetro fdwSuggest , alguns membros da estrutura apontada por pwfxDst podem exigir inicialização.

cbwfxDst

Tamanho, em bytes, disponível para o formato de destino. As funções acmMetrics e acmFormatTagDetails podem ser usadas para determinar o tamanho máximo necessário para qualquer formato disponível para o driver especificado (ou para todos os drivers ACM instalados).

fdwSuggest

Sinalizadores para correspondência do formato de destino desejado. Os valores a seguir são definidos.

Valor	Significado
ACM_FORMATSUGGESTF_NCHANNELS	O membro nChannels da estrutura apontada por pwfxDst é válido. O ACM consultará drivers instalados aceitáveis que podem sugerir um formato de destino que corresponda a nChannels ou falhe.
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	O membro nSamplesPerSec da estrutura apontada por pwfxDst é válido. O ACM consultará drivers instalados aceitáveis que podem sugerir um formato de destino correspondente a nSamplesPerSec ou falhar.
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	O membro wBitsPerSample da estrutura apontada por pwfxDst é válido. O ACM consultará drivers instalados aceitáveis que podem sugerir um formato de destino que corresponda a wBitsPerSample ou falhe.
ACM_FORMATSUGGESTF_WFORMATTAG	O membro wFormatTag da estrutura apontada por pwfxDst é válido. O ACM consultará drivers instalados aceitáveis que podem sugerir um formato de destino que corresponda a wFormatTag ou falhe.

Valor retornado

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
MMSYSERR_INVALFLAG	Pelo menos um sinalizador é inválido.
MMSYSERR_INVALHANDLE	O identificador especificado é inválido.
MMSYSERR_INVALPARAM	Pelo menos um parâmetro é inválido.

Requisitos


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

Compartilhar via