Compartilhar via


Função acmFilterDetailsW (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 acmFilterDetailsW(
  HACMDRIVER          had,
  LPACMFILTERDETAILSW 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 (./nf-msacm-acmfilterdetails.md) 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 .

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.

Comentários

Observação

O cabeçalho msacm.h define ACMFILTERDETAILS 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

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