Estructura ACMFILTERDETAILS (msacm.h)

Artículo
03/15/2023

La estructura ACMFILTERDETAILS detalla un filtro de audio de forma de onda para una etiqueta de filtro específica para un controlador ACM.

Sintaxis

typedef struct tACMFILTERDETAILS {
  DWORD        cbStruct;
  DWORD        dwFilterIndex;
  DWORD        dwFilterTag;
  DWORD        fdwSupport;
  LPWAVEFILTER pwfltr;
  DWORD        cbwfltr;
  char         szFilter[ACMFILTERDETAILS_FILTER_CHARS];
} ACMFILTERDETAILS, *PACMFILTERDETAILS, *LPACMFILTERDETAILS;

Members

cbStruct

Tamaño, en bytes, de la estructura ACMFILTERDETAILS . Este miembro debe inicializarse antes de llamar a las funciones acmFilterDetails o acmFilterEnum . El tamaño especificado en este miembro debe ser lo suficientemente grande como para contener la estructura base ACMFILTERDETAILS . Cuando la función acmFilterDetails devuelve, este miembro contiene el tamaño real de la información devuelta. La información devuelta nunca superará el tamaño solicitado.

dwFilterIndex

Índice del filtro sobre los detalles que se recuperarán. El índice oscila entre cero y uno menor que el número de filtros estándar admitidos por un controlador ACM para una etiqueta de filtro. El número de filtros estándar admitidos por un controlador para una etiqueta de filtro se encuentra en la estructura ACMFILTERTAGDETAILS . El miembro dwFilterIndex solo se usa al consultar los detalles del filtro estándar sobre un controlador por índice; de lo contrario, este miembro debe ser cero. Además, el ACM establecerá este miembro en cero cuando una aplicación consulte los detalles de un filtro; es decir, este miembro solo se usa para la entrada y nunca lo devuelve el controlador ACM o ACM.

dwFilterTag

Etiqueta de filtro de audio de forma de onda que describe la estructura ACMFILTERDETAILS . Este miembro se usa como entrada para la marca de consulta ACM_FILTERDETAILSF_INDEX. Para la marca de consulta ACM_FILTERDETAILSF_FORMAT, este miembro debe inicializarse en la misma etiqueta de filtro que el miembro pwfltr especifica. Si la función acmFilterDetails se realiza correctamente, este miembro siempre se devuelve. Este miembro debe establecerse en WAVE_FILTER_UNKNOWN para todas las demás marcas de consulta.

fdwSupport

Marcas de compatibilidad con controladores específicas del filtro especificado. Estas marcas son idénticas a la estructura ACMDRIVERDETAILS , pero son específicas del filtro que se está consultando. Este miembro puede ser una combinación de los siguientes valores e identifica las operaciones que admite el controlador para la etiqueta de filtro:

Nombre	Descripción
ACMDRIVERDETAILS_SUPPORTF_ASYNC	El controlador admite conversiones asincrónicas.
ACMDRIVERDETAILS_SUPPORTF_CODEC	El controlador admite la conversión entre dos etiquetas de formato diferentes al usar el filtro especificado. Por ejemplo, si un controlador admite la compresión de WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con el filtro 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 filtro especificado. Por ejemplo, si un controlador admite el muestreo de WAVE_FORMAT_PCM con el filtro 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). 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 con el filtro especificado 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étricas ACM_METRIC_HARDWARE_WAVE_INPUT y ACM_METRIC_HARDWARE_WAVE_OUTPUT para recuperar los identificadores de dispositivo de audio de forma de onda asociados al controlador ACM compatible.

pwfltr

Puntero a una estructura WAVEFILTER que recibirá los detalles del filtro. Esta estructura no requiere ninguna inicialización por parte de la aplicación a menos que se especifique la marca ACM_FILTERDETAILSF_FILTER con la función acmFilterDetails . En este caso, el miembro dwFilterTag de la estructura WAVEFILTER debe ser igual al miembro dwFilterTag de la estructura ACMFILTERDETAILS .

cbwfltr

Tamaño, en bytes, disponible para pwfltr para recibir los detalles del filtro. Las funciones acmMetrics y acmFilterTagDetails se pueden usar para determinar el tamaño máximo necesario para cualquier filtro disponible para el controlador especificado (o para todos los controladores ACM instalados).

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

Cadena que describe el filtro para el tipo dwFilterTag . Si la función acmFilterDetails se realiza correctamente, siempre se devuelve esta cadena.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	msacm.h