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 |