Función de devolución de llamada ACMFORMATENUMCB (msacm.h)
La función acmFormatEnumCallback especifica una función de devolución de llamada que se usa con la función acmFormatEnum . El nombre acmFormatEnumCallback es un marcador de posición para el nombre de la función definida por la aplicación.
Sintaxis
ACMFORMATENUMCB Acmformatenumcb;
BOOL Acmformatenumcb(
HACMDRIVERID hadid,
LPACMFORMATDETAILS pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parámetros
hadid
Identificador del controlador de ACM.
pafd
Puntero a una estructura 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
Los controladores admiten marcas específicas del controlador identificado por la estructura ACMDRIVERDETAILS , pero son específicas del formato que se está enumerando. Este parámetro puede ser una combinación de los valores siguientes 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 reamuestreo 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 al 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.
Comentarios
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, 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 |