Función de devolución de llamada ACMFORMATENUMCBW (msacm.h)
La función acmFormatEnumCallback especifica una función de devolución de llamada usada con la función acmFormatEnum. El acmFormatEnumCallback nombre es un marcador de posición para el nombre de función definido por la aplicación.
ACMFORMATENUMCBW Acmformatenumcbw;
BOOL Acmformatenumcbw(
HACMDRIVERID hadid,
LPACMFORMATDETAILSW pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
hadid
Identificador del controlador de ACM.
pafd
Puntero a una estructura de ACMFORMATDETAILS que contiene los detalles de formato enumerados para una etiqueta de formato.
dwInstance
Valor definido por la aplicación especificado en la función acmFormatEnum.
fdwSupport
El controlador admite marcas específicas del controlador identificado por estructura de ACMDRIVERDETAILS, pero son específicas del formato que se está enumerando. Este parámetro puede ser una combinación de los siguientes valores e indica qué operaciones admite el controlador para la etiqueta de formato.
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 para el formato especificado. Por ejemplo, si un controlador admite la compresión de WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con el formato 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 formato especificado. Por ejemplo, si un controlador admite el remuestreo de WAVE_FORMAT_PCM en el formato 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) con el formato especificado. 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 etiquetas de formato especificadas 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étrica 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. |
La función de devolución de llamada debe devolver TRUE para continuar con la enumeración o FALSE para detener la enumeración.
La función acmFormatEnum devolverá MMSYSERR_NOERROR (cero) si no se va a enumerar ningún formato. 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 ACMFORMATENUMCB 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.
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 |
funciones de compresión de audio de