Função acmFilterDetails (msacm.h)

A função acmFilterDetails consulta o ACM para obter detalhes sobre um filtro com uma marca de filtro waveform-audio específica.

Sintaxe

MMRESULT ACMAPI acmFilterDetails(
  HACMDRIVER         had,
  LPACMFILTERDETAILS pafd,
  DWORD              fdwDetails
);

Parâmetros

had

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

pafd

Ponteiro para a estrutura ACMFILTERDETAILS que deve receber os detalhes do filtro da marca de filtro fornecida.

fdwDetails

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

[ACMFILTERDETAILS] () a estrutura foi fornecida e os detalhes restantes devem ser retornados. O membro dwFilterTag da estrutura ACMFILTERDETAILS deve ser inicializado para a mesma marca de filtro especificada por pwfltr . Esse tipo de consulta pode ser usado para obter uma descrição de cadeia de caracteres de uma estrutura de filtro arbitrária. Se um aplicativo especificar um identificador de driver do ACM para had, os detalhes sobre o filtro 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_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX	Um índice de filtro para a marca de filtro foi fornecido no membro dwFilterIndex da estrutura ACMFILTERDETAILS . Os detalhes do filtro serão retornados na estrutura definida pelo pafd. O índice varia de zero a um a menos que o membro cStandardFilters retornado na estrutura ACMFILTERTAGDETAILS para uma marca de filtro. Um aplicativo deve especificar um identificador de driver para had ao recuperar detalhes do filtro com esse sinalizador. Para obter informações sobre quais membros devem ser inicializados antes de chamar essa função, consulte a estrutura ACMFILTERDETAILS .

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.

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