função acmFilterEnumA (msacm.h)

Artigo
11/20/2024

A função acmFilterEnum enumera filtros de áudio de forma de onda disponíveis para uma determinada marca de filtro de um driver ACM. Essa função continua enumerando até que não haja filtros mais adequados para a marca de filtro ou a função de retorno de chamada retorna FALSE.

Sintaxe

MMRESULT ACMAPI acmFilterEnumA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA pafd,
  ACMFILTERENUMCBA    fnCallback,
  DWORD_PTR           dwInstance,
  DWORD               fdwEnum
);

Parâmetros

had

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

pafd

Ponteiro para a estrutura de ACMFILTERDETAILS que contém os detalhes do filtro quando ele é passado para a função especificada por fnCallback. Quando seu aplicativo chama acmFilterEnum, os membros cbStruct, pwfltre cbwfltr membros dessa estrutura devem ser inicializados. O membro dwFilterTag também deve ser inicializado para WAVE_FILTER_UNKNOWN ou uma marca de filtro válida.

fnCallback

Endereço de instância de procedimento da função de retorno de chamada definida pelo aplicativo.

dwInstance

Um valor definido pelo aplicativo de 32 bits (DWORD), de 64 bits (DWORD_PTR) que é passado para a função de retorno de chamada junto com os detalhes do filtro ACM.

fdwEnum

Sinalizadores para enumerar os filtros para uma determinada marca de filtro. Os valores a seguir são definidos.

[ACMFILTERDETAILS]A estrutura (./nf-msacm-acmfilterdetails.md) é válida. O enumerador enumerará apenas um filtro que esteja em conformidade com esse atributo. O dwFilterTag membro da estrutura deACMFILTERDETAILS deve ser igual ao membro dwFilterTag da estrutura WAVEFILTER.

Valor	Significado
ACM_FILTERENUMF_DWFILTERTAG

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 do filtro não podem ser retornados.
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

A função acmFilterEnum retornará MMSYSERR_NOERROR (zero) se nenhum drivers ACM adequados estiver instalado. Além disso, a função de retorno de chamada não será chamada.

As seguintes funções não devem ser chamadas de dentro da função de retorno de chamada: acmDriverAdd, acmDriverRemovee acmDriverPriority.

Nota

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