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

Artigo
11/20/2024

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

ACMFORMATTAGENUMCBW Acmformattagenumcbw;

BOOL Acmformattagenumcbw(
  HACMDRIVERID hadid,
  LPACMFORMATTAGDETAILSW paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parâmetros

hadid

Manipule para o identificador do driver do ACM.

paftd

Ponteiro para uma estrutura de 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 de 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 marca de formato especificada por meio de um dispositivo de áudio waveform. 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 compatível.

Valor de retorno

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

Observações

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, acmDriverRemovee acmDriverPriority.

Nota

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

Consulte também

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

do Gerenciador de Compactação de Áudio

Compartilhar via