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

Consulte también

Funciones de compresión de audio

Administrador de compresión de audio