Função acmFilterTagDetailsW (msacm.h)
A função acmFilterTagDetails consulta o ACM para obter detalhes sobre uma marca de filtro de áudio de forma de onda específica.
Sintaxe
MMRESULT ACMAPI acmFilterTagDetailsW(
HACMDRIVER had,
LPACMFILTERTAGDETAILSW paftd,
DWORD fdwDetails
);
Parâmetros
had
Manipule para o driver do ACM para consultar detalhes da marca de filtro waveform-audio. Se esse parâmetro for NULL, o ACM usará os detalhes do primeiro driver ACM adequado. Um aplicativo deve especificar um identificador HACMDRIVER ou HACMDRIVERID válido ao usar o tipo de consulta ACM_FILTERTAGDETAILSF_INDEX. Identificadores de driver para drivers desabilitados não são permitidos.
paftd
Ponteiro para a estrutura ACMFILTERTAGDETAILS que deve receber os detalhes da marca de filtro.
fdwDetails
Sinalizadores para obter os detalhes. Os valores a seguir são definidos.
[ACMFILTERTAGDETAILS] Estrutura (./nf-msacm-acmfiltertagdetails.md). Os detalhes da marca de filtro serão retornados na estrutura apontada por paftd. Se um aplicativo especificar um identificador de driver do ACM para had, os detalhes sobre a marca de filtro serão retornados para esse driver. Se um aplicativo especificar NULL para had, o ACM encontrará o primeiro driver aceitável para retornar os detalhes. [ACMDRIVERDETAILS] Estrutura (./nf-msacm-acmdriverdetails.md) para um driver ACM. Um aplicativo deve especificar um identificador de driver para had ao recuperar detalhes da marca de filtro com esse sinalizador.Valor | Significado |
---|---|
ACM_FILTERTAGDETAILSF_FILTERTAG | |
ACM_FILTERTAGDETAILSF_INDEX | |
ACM_FILTERTAGDETAILSF_LARGESTSIZE | Detalhes sobre a marca de filtro com o maior tamanho de filtro, em bytes, devem ser retornados. O membro dwFilterTag deve ser WAVE_FILTER_UNKNOWN ou a marca de filtro para o qual localizar o maior tamanho. Se um aplicativo especificar um identificador de driver do ACM para had, os detalhes sobre a maior marca de filtro serão retornados para esse driver. Se um aplicativo especificar NULL para had, o ACM encontrará um driver aceitável com a maior marca de filtro solicitada para retornar os detalhes. |
Valor retornado
Retornará zero se tiver êxito ou um erro, caso contrário. Os valores de erro possíveis incluem o seguinte.
Código de retorno | Descrição |
---|---|
|
Os detalhes solicitados não estão disponíveis. |
|
Pelo menos um sinalizador é inválido. |
|
O identificador especificado é inválido. |
|
Pelo menos um parâmetro é inválido. |
Comentários
Observação
O cabeçalho msacm.h define ACMFILTERTAGDETAILS 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