Función de devolución de llamada ACMFILTERTAGENUMCBW (msacm.h)
La función acmFilterTagEnumCallback especifica una función de devolución de llamada usada con la función acmFilterTagEnum . El nombre de la función acmFilterTagEnumCallback es un marcador de posición para un nombre de función definido por la aplicación.
Sintaxis
ACMFILTERTAGENUMCBW Acmfiltertagenumcbw;
BOOL Acmfiltertagenumcbw(
HACMDRIVERID hadid,
LPACMFILTERTAGDETAILSW paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parámetros
hadid
Identificador del controlador ACM.
paftd
Puntero a una estructura ACMFILTERTAGDETAILS que contiene los detalles de la etiqueta de filtro enumerada.
dwInstance
Valor definido por la aplicación especificado en acmFilterTagEnum.
fdwSupport
Marcas de compatibilidad con controladores específicas del identificador de controlador ACMDRIVERDETAILS . Este parámetro puede ser una combinación de los valores siguientes e identifica las operaciones que admite el controlador con la etiqueta de filtro.
Valor | Significado |
---|---|
ACMDRIVERDETAILS_SUPPORTF_ASYNC | El controlador admite conversiones asincrónicas con la etiqueta de filtro especificada. |
ACMDRIVERDETAILS_SUPPORTF_CODEC | El controlador admite la conversión entre dos etiquetas de formato diferentes al usar la etiqueta de filtro especificada. Por ejemplo, si un controlador admite la compresión de WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con la etiqueta de filtro especificada, se establece esta marca. |
ACMDRIVERDETAILS_SUPPORTF_CONVERTER | El controlador admite la conversión entre dos formatos diferentes de la misma etiqueta de formato mientras se usa la etiqueta de filtro especificada. Por ejemplo, si un controlador admite el muestreo de WAVE_FORMAT_PCM con la etiqueta de filtro especificada, se establece esta marca. |
ACMDRIVERDETAILS_SUPPORTF_FILTER | El controlador admite un filtro (modificación de los datos sin cambiar ninguno de los atributos de formato). Por ejemplo, si un controlador admite operaciones de volumen o eco en WAVE_FORMAT_PCM, se establece esta marca. |
ACMDRIVERDETAILS_SUPPORTF_HARDWARE | El controlador admite la entrada de hardware, la salida o ambas con la etiqueta de filtro especificada a través de un dispositivo de audio de forma de onda. Una aplicación debe usar la función acmMetrics con los índices de métricas de ACM_METRIC_HARDWARE_WAVE_INPUT y ACM_METRIC_HARDWARE_WAVE_OUTPUT para obtener los identificadores de dispositivo de audio de forma de onda asociados al controlador ACM compatible. |
Valor devuelto
La función de devolución de llamada debe devolver TRUE para continuar la enumeración o FALSE para detener la enumeración.
Comentarios
La función acmFilterTagEnum devuelve MMSYSERR_NOERROR (cero) si no se van a enumerar etiquetas de filtro. Además, no se llamará a la función de devolución de llamada.
No se debe llamar a las siguientes funciones desde dentro de la función de devolución de llamada: acmDriverAdd, acmDriverRemove y acmDriverPriority.
Nota:
El encabezado msacm.h define ACMFILTERTAGENUMCB como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | msacm.h |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de