Función de devolución de llamada ACMFILTERENUMCBW (msacm.h)

La función acmFilterEnumCallback especifica una función de devolución de llamada usada con la función acmFilterEnum. El acmFilterEnumCallback nombre es un marcador de posición para un nombre de función definido por la aplicación.

Sintaxis

ACMFILTERENUMCBW Acmfilterenumcbw;

BOOL Acmfilterenumcbw(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILSW pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parámetros

hadid

Identificador del controlador de ACM.

pafd

Puntero a una estructura de ACMFILTERDETAILS que contiene los detalles de filtro enumerados para una etiqueta de filtro.

dwInstance

Valor definido por la aplicación especificado en acmFilterEnum.

fdwSupport

Marcas de compatibilidad con controladores específicas del controlador identificadas por estructura ACMDRIVERDETAILS, pero son específicas del filtro que se está enumerando. Este parámetro puede ser una combinación de los siguientes valores e identifica las operaciones que admite el controlador para 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 mientras se usa el filtro especificado. Por ejemplo, si un controlador admite la compresión de WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con el filtro especificado, 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 el filtro especificado. Por ejemplo, si un controlador admite el remuestreo de WAVE_FORMAT_PCM con el filtro especificado, 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 el filtro especificado 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 con el controlador ACM compatible.

Valor devuelto

La función de devolución de llamada debe devolver TRUE para continuar con la enumeración o FALSE para detener la enumeración.

Observaciones

La función acmFilterEnum devolverá MMSYSERR_NOERROR (cero) si no se enumera ningún 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, acmDriverRemovey acmDriverPriority.

Nota

El encabezado msacm.h define ACMFILTERENUMCB 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	msacm.h

Consulte también

funciones de compresión de audio de

administrador de compresión de audio