Función de devolución de llamada ACMDRIVERENUMCB (msacm.h)
La función acmDriverEnumCallback especifica una función de devolución de llamada usada con la función acmDriverEnum . El nombre acmDriverEnumCallback es un marcador de posición para un nombre de función definido por la aplicación.
Sintaxis
ACMDRIVERENUMCB Acmdriverenumcb;
BOOL Acmdriverenumcb(
HACMDRIVERID hadid,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parámetros
hadid
Identificador de controlador de ACM.
dwInstance
Valor definido por la aplicación especificado en acmDriverEnum.
fdwSupport
Marcas de compatibilidad con controladores específicas del controlador especificadas por la estructura ACMDRIVERDETAILS . Este parámetro puede ser una combinación de los valores siguientes.
| Value | Significado |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | El controlador admite conversiones asincrónicas. |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | El controlador admite la conversión entre dos etiquetas de formato diferentes. 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 misma etiqueta de formato. Por ejemplo, si un controlador admite el muestreo de WAVE_FORMAT_PCM, se establece esta marca. |
| ACMDRIVERDETAILS_SUPPORTF_DISABLED | El controlador se ha deshabilitado. Una aplicación debe especificar la marca ACM_DRIVERENUMF_DISABLED con acmDriverEnum para incluir controladores deshabilitados en la enumeración. |
| 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. |
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 acmDriverEnum devolverá MMSYSERR_NOERROR (cero) si no hay ningún controlador ACM instalado. 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
| Requisito | Value |
|---|---|
| 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 |