Función de devolución de llamada ACMFORMATTAGENUMCB (msacm.h)
La función acmFormatTagEnumCallback especifica una función de devolución de llamada usada con la función acmFormatTagEnum . El nombre acmFormatTagEnumCallback es un marcador de posición para un nombre de función definido por la aplicación.
Sintaxis
ACMFORMATTAGENUMCB Acmformattagenumcb;
BOOL Acmformattagenumcb(
HACMDRIVERID hadid,
LPACMFORMATTAGDETAILS paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parámetros
hadid
Identificador del controlador ACM.
paftd
Puntero a una estructura ACMFORMATTAGDETAILS que contiene los detalles de etiqueta de formato enumerados.
dwInstance
Valor definido por la aplicación especificado en la función acmFormatTagEnum .
fdwSupport
Marcas de compatibilidad con controladores específicas de la etiqueta de formato. Estas marcas son idénticas a la estructura ACMDRIVERDETAILS . Este parámetro puede ser una combinación de los valores siguientes e indica qué operaciones admite el controlador con 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, donde una de las etiquetas es la etiqueta de formato especificada. Por ejemplo, si un controlador admite la compresión de WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM, se establece esta marca. |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | El controlador admite la conversión entre dos formatos diferentes de la etiqueta de formato especificada. Por ejemplo, si un controlador admite el muestreo de WAVE_FORMAT_PCM, 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 la etiqueta de formato especificada, se establece esta marca. |
| ACMDRIVERDETAILS_SUPPORTF_HARDWARE | El controlador admite la entrada de hardware, la salida o ambas de la etiqueta de formato especificada a través de un dispositivo de audio de forma de onda. Una aplicación debe usar 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 acmFormatTagEnum devolverá MMSYSERR_NOERROR (cero) si no se van a enumerar etiquetas de 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, acmDriverRemove y acmDriverPriority.
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 |