Estructura ACMFILTERTAGDETAILS (msacm.h)

La estructura ACMFILTERTAGDETAILS detalla una etiqueta de filtro de formato de onda para un controlador de filtro ACM.

Sintaxis

typedef struct tACMFILTERTAGDETAILS {
  DWORD cbStruct;
  DWORD dwFilterTagIndex;
  DWORD dwFilterTag;
  DWORD cbFilterSize;
  DWORD fdwSupport;
  DWORD cStandardFilters;
  char  szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
} ACMFILTERTAGDETAILS, *PACMFILTERTAGDETAILS, *LPACMFILTERTAGDETAILS;

Members

cbStruct

Tamaño, en bytes, de la estructura ACMFILTERTAGDETAILS . Este miembro debe inicializarse antes de que una aplicación llame a la función acmFilterTagDetails o acmFilterTagEnum . El tamaño especificado en este miembro debe ser lo suficientemente grande como para contener la estructura base ACMFILTERTAGDETAILS . Cuando la función acmFilterTagDetails devuelve, este miembro contiene el tamaño real de la información devuelta. La información devuelta nunca superará el tamaño solicitado.

dwFilterTagIndex

Índice de la etiqueta de filtro para la que se van a recuperar los detalles. El índice va de cero a uno menor que el número de etiquetas de filtro compatibles con un controlador ACM. El número de etiquetas de filtro admitidas por un controlador se encuentra en la estructura ACMDRIVERDETAILS . El miembro dwFilterTagIndex solo se usa al consultar los detalles de la etiqueta de filtro sobre un controlador por índice; de lo contrario, este miembro debe ser cero.

dwFilterTag

Etiqueta de filtro de audio de forma de onda que describe la estructura ACMFILTERTAGDETAILS . Este miembro se usa como entrada para las marcas de consulta ACM_FILTERTAGDETAILSF_FILTERTAG y ACM_FILTERTAGDETAILSF_LARGESTSIZE. Este miembro siempre se devuelve si la función acmFilterTagDetails es correcta. Este miembro debe establecerse en WAVE_FILTER_UNKNOWN para todas las demás marcas de consulta.

cbFilterSize

Tamaño total más grande, en bytes, de un filtro de audio de forma de onda del tipo dwFilterTag . Por ejemplo, este miembro será 40 para WAVE_FILTER_ECHO y 36 para WAVE_FILTER_VOLUME.

fdwSupport

Marcas de compatibilidad con controladores específicas de la etiqueta de filtro. Estas marcas son idénticas a la estructura ACMDRIVERDETAILS . Este miembro puede ser una combinación de los siguientes valores e identifica qué operaciones admite el controlador con 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 la etiqueta de filtro especificada. Por ejemplo, si un controlador admite la compresión de WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con la etiqueta de filtro especificada, 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 la etiqueta de filtro especificada. Por ejemplo, si un controlador admite el muestreo de WAVE_FORMAT_PCM con la etiqueta de filtro especificada, 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 la etiqueta de filtro especificada 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 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.

cStandardFilters

Número de filtros estándar del tipo dwFilterTag (es decir, la combinación de todas las características del filtro). Este valor no puede especificar todos los filtros admitidos por el controlador.

szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS]

Cadena que describe el tipo dwFilterTag . Esta cadena siempre se devuelve si la función acmFilterTagDetails es correcta.

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

Consulte también

ACMDRIVERDETAILS

Administrador de compresión de audio

Estructuras de compresión de audio

acmFilterTagDetails

acmFilterTagEnum