Estructura ACMFORMATTAGDETAILS (msacm.h)
La estructura ACMFORMATTAGDETAILS detalla una etiqueta de formato de formato de onda y audio para un controlador ACM.
Sintaxis
typedef struct tACMFORMATTAGDETAILS {
DWORD cbStruct;
DWORD dwFormatTagIndex;
DWORD dwFormatTag;
DWORD cbFormatSize;
DWORD fdwSupport;
DWORD cStandardFormats;
char szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;
Members
cbStruct
Tamaño, en bytes, de la estructura ACMFORMATTAGDETAILS . Este miembro debe inicializarse antes de que una aplicación llame a la función acmFormatTagDetails o acmFormatTagEnum . El tamaño especificado por este miembro debe ser lo suficientemente grande como para contener la estructura base ACMFORMATTAGDETAILS . Cuando la función acmFormatTagDetails devuelve, este miembro contiene el tamaño real de la información devuelta. La información devuelta nunca superará el tamaño solicitado.
dwFormatTagIndex
Índice de la etiqueta de formato para la que se recuperarán los detalles. El índice va de cero a uno menor que el número de etiquetas de formato compatibles con un controlador ACM. El número de etiquetas de formato admitidas por un controlador se encuentra en la estructura ACMDRIVERDETAILS . El miembro dwFormatTagIndex solo se usa al consultar los detalles de la etiqueta de formato en un controlador por índice; de lo contrario, este miembro debe ser cero.
dwFormatTag
Etiqueta de formato de audio de forma de onda que describe la estructura ACMFORMATTAGDETAILS . Este miembro se usa para la entrada de las marcas de consulta ACM_FORMATTAGDETAILSF_FORMATTAG y ACM_FORMATTAGDETAILSF_LARGESTSIZE. Si la función acmFormatTagDetails es correcta, este miembro siempre se devuelve. Este miembro debe establecerse en WAVE_FORMAT_UNKNOWN para todas las demás marcas de consulta.
cbFormatSize
Tamaño total más grande, en bytes, de un formato de audio de forma de onda del tipo dwFormatTag . Por ejemplo, este miembro será 16 para WAVE_FORMAT_PCM y 50 para WAVE_FORMAT_ADPCM.
fdwSupport
Marcas de compatibilidad con controladores específicas de la etiqueta de formato. Estas marcas son idénticas a la estructura ACMDRIVERDETAILS . Este miembro puede ser una combinación de los siguientes valores y hacer referencia a las operaciones que admite el controlador con la etiqueta de formato:
| Nombre | Descripción |
|---|---|
|
El controlador admite conversiones asincrónicas con la etiqueta de formato especificada. |
|
El controlador admite la conversión entre dos etiquetas de formato diferentes, donde una de las etiquetas es la etiqueta de formato especificada. Por ejemplo, si un controlador admite la compresión de WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM, se establece esta marca. |
|
El controlador admite la conversión entre dos formatos diferentes de la etiqueta de formato especificada. Por ejemplo, si un controlador admite el muestreo de WAVE_FORMAT_PCM, se establece esta marca. |
|
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 la etiqueta de formato especificada, se establece esta marca. |
|
El controlador admite la entrada de hardware, la salida o ambas de la etiqueta de formato 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. |
cStandardFormats
Número de formatos estándar del tipo dwFormatTag ; es decir, la combinación de todas las velocidades de muestreo, bits por muestra, canales, etc. Este valor puede especificar todos los formatos admitidos por el controlador, pero no necesariamente.
szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]
Cadena que describe el tipo dwFormatTag . Si la función acmFormatTagDetails 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 |
Consulte también
Administrador de compresión de audio