Share via

Função de retorno de chamada ACMFILTERTAGENUMCBW (msacm.h)

  • Artigo

A função acmFilterTagEnumCallback especifica uma função de retorno de chamada usada com a função acmFilterTagEnum . O nome da função acmFilterTagEnumCallback é um espaço reservado para um nome de função definido pelo aplicativo.

Sintaxe

ACMFILTERTAGENUMCBW Acmfiltertagenumcbw;

BOOL Acmfiltertagenumcbw(
  HACMDRIVERID hadid,
  LPACMFILTERTAGDETAILSW paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parâmetros

hadid

Manipule para o identificador do driver do ACM.

paftd

Ponteiro para uma estrutura ACMFILTERTAGDETAILS que contém os detalhes da marca de filtro enumerado.

dwInstance

Valor definido pelo aplicativo especificado em acmFilterTagEnum.

fdwSupport

Sinalizadores de suporte ao driver específicos para a estrutura ACMDRIVERDETAILS do identificador de driver. Esse parâmetro pode ser uma combinação dos valores a seguir e identifica quais operações o driver dá suporte com a marca de filtro.

Valor Significado
ACMDRIVERDETAILS_SUPPORTF_ASYNC O driver dá suporte a conversões assíncronas com a marca de filtro especificada.
ACMDRIVERDETAILS_SUPPORTF_CODEC O driver dá suporte à conversão entre duas marcas de formato diferentes ao usar a marca de filtro especificada. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM com a marca de filtro especificada, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER O driver dá suporte à conversão entre dois formatos diferentes da mesma marca de formato ao usar a marca de filtro especificada. Por exemplo, se um driver der suporte à ressampling de WAVE_FORMAT_PCM com a marca de filtro especificada, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_FILTER O driver dá suporte a um filtro (modificação dos dados sem alterar nenhum dos atributos de formato). Por exemplo, se um driver der suporte a operações de volume ou eco em WAVE_FORMAT_PCM, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE O driver dá suporte à entrada, saída ou ambos de hardware com a marca de filtro especificada por meio de um dispositivo de áudio de forma de onda. Um aplicativo deve usar a função acmMetrics com os índices de métrica ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT para obter os identificadores de dispositivo waveform-audio associados ao driver ACM de suporte.

Valor retornado

A função de retorno de chamada deve retornar TRUE para continuar a enumeração ou FALSE para interromper a enumeração.

Comentários

A função acmFilterTagEnum retornará MMSYSERR_NOERROR (zero) se nenhuma marca de filtro for enumerada. 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, acmDriverRemove e acmDriverPriority.

Observação

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

   
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

Confira também

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

Gerenciador de Compactação de Áudio