Função de retorno de chamada ACMFILTERENUMCB (msacm.h)
A função acmFilterEnumCallback especifica uma função de retorno de chamada usada com a função acmFilterEnum . O nome acmFilterEnumCallback é um espaço reservado para um nome de função definido pelo aplicativo.
Sintaxe
ACMFILTERENUMCB Acmfilterenumcb;
BOOL Acmfilterenumcb(
HACMDRIVERID hadid,
LPACMFILTERDETAILS pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parâmetros
hadid
Manipule para o identificador do driver do ACM.
pafd
Ponteiro para uma estrutura ACMFILTERDETAILS que contém os detalhes do filtro enumerado para uma marca de filtro.
dwInstance
Valor definido pelo aplicativo especificado em acmFilterEnum.
fdwSupport
Sinalizadores de suporte ao driver específicos para o driver identificado pela estrutura ACMDRIVERDETAILS , mas eles são específicos para o filtro que está sendo enumerado. Esse parâmetro pode ser uma combinação dos valores a seguir e identifica quais operações o driver dá suporte para a marca de filtro.
| 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 ao usar o filtro especificado. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM com o filtro especificado, esse sinalizador será definido. |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | O driver dá suporte à conversão entre dois formatos diferentes da mesma marca de formato ao usar o filtro especificado. Por exemplo, se um driver der suporte à ressampling de WAVE_FORMAT_PCM com o filtro especificado, 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 em WAVE_FORMAT_PCM, esse sinalizador será definido. |
| ACMDRIVERDETAILS_SUPPORTF_HARDWARE | O driver dá suporte à entrada, saída ou ambos de hardware com o filtro especificado por meio de um dispositivo de áudio de forma de onda. Um aplicativo deve usar a função acmMetrics com os índices de métrica ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT para obter os identificadores de dispositivo de áudio de forma de onda 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 acmFilterEnum retornará MMSYSERR_NOERROR (zero) se nenhum filtro for enumerado. 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 |