Função acmFormatDetails (msacm.h)

Artigo
03/05/2024

A função acmFormatDetails consulta o ACM para obter detalhes de formato para uma marca específica de formato waveform-audio.

Sintaxe

MMRESULT ACMAPI acmFormatDetails(
  HACMDRIVER         had,
  LPACMFORMATDETAILS pafd,
  DWORD              fdwDetails
);

Parâmetros

had

Manipule para o driver do ACM para consultar detalhes do formato waveform-audio para uma marca de formato. Se esse parâmetro for NULL, o ACM usará os detalhes do primeiro driver ACM adequado.

pafd

Ponteiro para uma estrutura ACMFORMATDETAILS para conter os detalhes de formato da marca de formato fornecida.

fdwDetails

Sinalizadores para obter os detalhes da marca de formato waveform-audio. Os valores a seguir são definidos.

[ACMFORMATDETAILS] () a estrutura foi fornecida e os detalhes restantes devem ser retornados. O membro dwFormatTag da estrutura ACMFORMATDETAILS deve ser inicializado para a mesma marca de formato especificada por pwfx . Esse tipo de consulta pode ser usado para obter uma descrição de cadeia de caracteres de uma estrutura de formato arbitrário. Se um aplicativo especificar um identificador de driver do ACM para had, os detalhes sobre o formato serão retornados para esse driver. Se um aplicativo especificar NULL para had, o ACM encontrará o primeiro driver aceitável para retornar os detalhes.

Valor	Significado
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Um índice de formato para a marca de formato foi fornecido no membro dwFormatIndex da estrutura ACMFORMATDETAILS . Os detalhes do formato serão retornados na estrutura definida pelo pafd. O índice varia de zero a um a menos do que o membro cStandardFormats retornado na estrutura ACMFORMATTAGDETAILS para uma marca de formato. Um aplicativo deve especificar um identificador de driver para had ao recuperar detalhes de formato com esse sinalizador. Para obter informações sobre quais membros devem ser inicializados antes de chamar essa função, consulte a estrutura ACMFORMATDETAILS .

Valor

Significado

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Um índice de formato para a marca de formato foi fornecido no membro dwFormatIndex da estrutura ACMFORMATDETAILS . Os detalhes do formato serão retornados na estrutura definida pelo pafd. O índice varia de zero a um a menos do que o membro cStandardFormats retornado na estrutura ACMFORMATTAGDETAILS para uma marca de formato. Um aplicativo deve especificar um identificador de driver para had ao recuperar detalhes de formato com esse sinalizador. Para obter informações sobre quais membros devem ser inicializados antes de chamar essa função, consulte a estrutura ACMFORMATDETAILS .

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	Os detalhes solicitados não estão disponíveis.
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

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

Compartilhar via