função acmFilterDetailsA (msacm.h)

Artigo
11/20/2024

A função acmFilterDetails consulta o ACM para obter detalhes sobre um filtro com uma marca de filtro de áudio de forma de onda específica.

Sintaxe

MMRESULT ACMAPI acmFilterDetailsA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA 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 de ACMFILTERDETAILS que deve receber os detalhes do filtro para a 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 dwFilterTag membro da estrutura deACMFILTERDETAILS deve ser inicializado para a mesma marca de filtro especifica 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 ACM para tiver, os detalhes sobre o filtro serão retornados para esse driver. Se um aplicativo especificar NULL para , 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 de ACMFILTERDETAILS. Os detalhes do filtro serão retornados na estrutura definida por pafd. O índice varia de zero a um a menos do que o membro cStandardFilters retornado na estrutura de ACMFILTERTAGDETAILS para uma marca de filtro. Um aplicativo deve especificar um identificador de driver para teve 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 de ACMFILTERDETAILS .

Valor

Significado

ACM_FILTERDETAILSF_FILTER

ACM_FILTERDETAILSF_INDEX

Um índice de filtro para a marca de filtro foi fornecido no membro dwFilterIndex da estrutura de ACMFILTERDETAILS. Os detalhes do filtro serão retornados na estrutura definida por pafd. O índice varia de zero a um a menos do que o membro cStandardFilters retornado na estrutura de ACMFILTERTAGDETAILS para uma marca de filtro. Um aplicativo deve especificar um identificador de driver para teve 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 de ACMFILTERDETAILS .

Valor de retorno

Retornará 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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	msacm.h
biblioteca	Msacm32.lib
de DLL	Msacm32.dll

Consulte também

Funções de compactação de áudio

do Gerenciador de Compactação de Áudio

Compartilhar via