Função de retorno de chamada ACMFORMATTAGENUMCBA (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
ACMFORMATTAGENUMCBA Acmformattagenumcba;
BOOL Acmformattagenumcba(
HACMDRIVERID hadid,
LPACMFORMATTAGDETAILSA paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parâmetros
hadid
Manipule para o identificador do 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 à reexame 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. |
Retornar valor
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.
Observação
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 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
| Requisito | Valor |
|---|---|
| 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 |