Estructura ACMFORMATDETAILS (msacm.h)
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 |
---|---|
|
El controlador admite conversiones asincrónicas con la etiqueta de formato especificada. |
|
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. |
|
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. |
|
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. |
|
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 |
Consulte también
Administrador de compresión de audio