Função acmFormatDetailsA (msacm.h)

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

Sintaxe

MMRESULT ACMAPI acmFormatDetailsA(
  HACMDRIVER          had,
  LPACMFORMATDETAILSA 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 (./nf-msacm-acmformatdetails.md) foi fornecida e os detalhes restantes devem ser retornados. O membro dwFormatTag da estrutura ACMFORMATDETAILS deve ser inicializado para a mesma marca de formato que pwfx especifica. 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 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 retornado

Retorna zero se tiver êxito ou um erro de outra forma. 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.

Comentários

Observação

O cabeçalho msacm.h define ACMFORMATDETAILS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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