Estructura ACMFORMATDETAILS (msacm.h)

Artículo
03/15/2023

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

Sintaxis

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

Miembros

cbStruct

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

dwFormatIndex

Índice del formato para el que se van a recuperar los detalles. El índice va de cero a uno menor que el número de formatos estándar admitidos por un controlador ACM para una etiqueta de formato. El número de formatos estándar admitidos por un controlador para una etiqueta de formato se encuentra en la estructura ACMFORMATTAGDETAILS . El miembro dwFormatIndex solo se usa cuando una aplicación consulta detalles de formato 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 formato; es decir, este miembro solo se usa para la entrada y nunca lo devuelve el controlador ACM o ACM.

dwFormatTag

Etiqueta de formato de audio de forma de onda que describe la estructura ACMFORMATDETAILS . Este miembro se usa para la entrada de la marca de consulta ACM_FORMATDETAILSF_INDEX. Para la marca de consulta ACM_FORMATDETAILSF_FORMAT, este miembro debe inicializarse en la misma etiqueta de formato que el miembro pwfx especifica. Si una llamada a la función acmFormatDetails se realiza correctamente, siempre se devuelve este miembro. Este miembro debe establecerse en WAVE_FORMAT_UNKNOWN para todas las demás marcas de consulta.

fdwSupport

Marcas de compatibilidad con controladores específicas del formato especificado. Estas marcas son idénticas a la estructura ACMDRIVERDETAILS . Este miembro puede ser una combinación de los valores siguientes e indica qué operaciones admite el controlador para la etiqueta de formato:

Nombre	Descripción
ACMDRIVERDETAILS_SUPPORTF_ASYNC	El controlador admite conversiones asincrónicas con la etiqueta de formato 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 (que modifica los datos sin cambiar ningún atributo 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 o la salida del formato especificado a través de un dispositivo de audio de forma de onda. Una aplicación debe usar acmMetrics con los índices de métricas 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.

pwfx

Puntero a una estructura WAVEFORMATEX que recibirá los detalles del formato. Esta estructura no requiere inicialización por parte de la aplicación a menos que se especifique la marca ACM_FORMATDETAILSF_FORMAT en la función acmFormatDetails . En este caso, el miembro wFormatTag de la estructura WAVEFORMATEX debe ser igual al dwFormatTag de la estructura ACMFORMATDETAILS .

cbwfx

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

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

Cadena que describe el formato del tipo dwFormatTag . Si la función acmFormatDetails se realiza correctamente, siempre se devuelve esta cadena.

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]
Encabezado	msacm.h