Função acmFilterEnumW (msacm.h)
A função acmFilterEnum enumera filtros waveform-audio disponíveis para uma determinada marca de filtro de um driver ACM. Essa função continua enumerando até que não haja filtros mais adequados para a marca de filtro ou a função de retorno de chamada retorne FALSE.
Sintaxe
MMRESULT ACMAPI acmFilterEnumW(
HACMDRIVER had,
LPACMFILTERDETAILSW pafd,
ACMFILTERENUMCBW fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Parâmetros
had
Manipule para o driver do ACM para consultar detalhes do filtro waveform-audio. Se esse parâmetro for NULL, o ACM usará os detalhes do primeiro driver ACM adequado.
pafd
Ponteiro para a estrutura ACMFILTERDETAILS que contém os detalhes do filtro quando ele é passado para a função especificada por fnCallback. Quando seu aplicativo chama acmFilterEnum, os membros cbStruct, pwfltr e cbwfltr dessa estrutura devem ser inicializados. O membro dwFilterTag também deve ser inicializado para WAVE_FILTER_UNKNOWN ou uma marca de filtro válida.
fnCallback
Endereço de instância de procedimento da função de retorno de chamada definida pelo aplicativo.
dwInstance
Um valor definido pelo aplicativo de 32 bits (DWORD), de 64 bits (DWORD_PTR) que é passado para a função de retorno de chamada junto com os detalhes do filtro do ACM.
fdwEnum
Sinalizadores para enumerar os filtros de uma determinada marca de filtro. Os valores a seguir são definidos.
[ACMFILTERDETAILS] A estrutura (./nf-msacm-acmfilterdetails.md) é válida. O enumerador enumerará apenas um filtro que esteja em conformidade com esse atributo. O membro dwFilterTag da estrutura ACMFILTERDETAILS deve ser igual ao membro dwFilterTag da estrutura WAVEFILTER .Valor | Significado |
---|---|
ACM_FILTERENUMF_DWFILTERTAG |
Valor retornado
Retorna zero se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.
Código de retorno | Descrição |
---|---|
|
Os detalhes do filtro não podem ser retornados. |
|
Pelo menos um sinalizador é inválido. |
|
O identificador especificado é inválido. |
|
Pelo menos um parâmetro é inválido. |
Comentários
A função acmFilterEnum retornará MMSYSERR_NOERROR (zero) se nenhum drivers ACM adequados 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.
Observação
O cabeçalho msacm.h define acmFilterEnum 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
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 |
Biblioteca | Msacm32.lib |
DLL | Msacm32.dll |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de