Compartilhar via


Função acmFormatTagDetails (msacm.h)

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

Sintaxe

MMRESULT ACMAPI acmFormatTagDetails(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  DWORD                 fdwDetails
);

Parâmetros

had

Manipule para o driver do ACM para consultar detalhes da marca de formato waveform-audio. Se esse parâmetro for NULL, o ACM usará os detalhes do primeiro driver ACM adequado. Um aplicativo deve especificar um identificador válido ou identificador de driver ao usar o tipo de consulta ACM_FORMATTAGDETAILSF_INDEX. Identificadores de driver para drivers desabilitados não são permitidos.

paftd

Ponteiro para a estrutura ACMFORMATTAGDETAILS que deve receber os detalhes da marca de formato.

fdwDetails

Sinalizadores para obter os detalhes. Os valores a seguir são definidos.

[ACMFORMATTAGDETAILS] () estrutura. Os detalhes da marca de formato serão retornados na estrutura apontada por paftd. Se um aplicativo especificar um identificador de driver do ACM para had, os detalhes sobre a marca de 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. [ACMDRIVERDETAILS] Estrutura (./nf-msacm-acmdriverdetails.md) para um driver ACM. Um aplicativo deve especificar um identificador de driver para had ao recuperar detalhes da marca de formato com esse sinalizador. [ACMFORMATTAGDETAILS] () a estrutura deve ser WAVE_FORMAT_UNKNOWN ou a marca de formato para a qual localizar o maior tamanho. Se um aplicativo especificar um identificador de driver do ACM para had, os detalhes sobre a maior marca de formato serão retornados para esse driver. Se um aplicativo especificar NULL para had, o ACM encontrará um driver aceitável com a maior marca de formato solicitada para retornar os detalhes.
Valor Significado
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

Retornar valor

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.

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