Compartilhar via


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

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

Sintaxe

ACMDRIVERENUMCB Acmdriverenumcb;

BOOL Acmdriverenumcb(
  HACMDRIVERID hadid,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parâmetros

hadid

Identificador para um identificador de driver do ACM.

dwInstance

Valor definido pelo aplicativo especificado em acmDriverEnum.

fdwSupport

Sinalizadores de suporte de driver específicos para o driver especificado pela estrutura ACMDRIVERDETAILS . Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor Significado
ACMDRIVERDETAILS_SUPPORTF_ASYNC O driver dá suporte a conversões assíncronas.
ACMDRIVERDETAILS_SUPPORTF_CODEC O driver dá suporte à conversão entre duas marcas de formato diferentes. 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 mesma marca de formato. Por exemplo, se um driver der suporte à resampação de WAVE_FORMAT_PCM, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_DISABLED O driver foi desabilitado. Um aplicativo deve especificar o sinalizador ACM_DRIVERENUMF_DISABLED com acmDriverEnum para incluir drivers desabilitados na enumeração.
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.

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 acmDriverEnum retornará MMSYSERR_NOERROR (zero) se nenhum driver ACM 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, acmDriverRemove e acmDriverPriority.

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

Confira também

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

Gerenciador de Compactação de Áudio