Compartilhar via


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

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

Sintaxe

ACMFORMATTAGENUMCB Acmformattagenumcb;

BOOL Acmformattagenumcb(
  HACMDRIVERID hadid,
  LPACMFORMATTAGDETAILS paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parâmetros

hadid

Identificador para o identificador de driver do ACM.

paftd

Ponteiro para uma estrutura ACMFORMATTAGDETAILS que contém os detalhes da marca de formato enumerado.

dwInstance

Valor definido pelo aplicativo especificado na função acmFormatTagEnum .

fdwSupport

Sinalizadores de suporte ao driver específicos para a marca de formato. Esses sinalizadores são idênticos à estrutura ACMDRIVERDETAILS . Esse parâmetro pode ser uma combinação dos valores a seguir e indica quais operações o driver dá suporte com a marca de formato.

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 em que uma das marcas é a marca de formato especificada. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER O driver dá suporte à conversão entre dois formatos diferentes da marca de formato especificada. Por exemplo, se um driver der suporte à resampação de WAVE_FORMAT_PCM, 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 na marca de formato especificada, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE O driver dá suporte à entrada de hardware, à saída ou a ambas as marcas de formato especificadas por meio de um dispositivo de áudio de forma de onda. Um aplicativo deve usar 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 acmFormatTagEnum retornará MMSYSERR_NOERROR (zero) se nenhuma marca de formato 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.

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