Función acmFormatSuggest (msacm.h)

Artículo
08/24/2023

La función acmFormatSuggest consulta el ACM o un controlador ACM especificado para sugerir un formato de destino para el formato de origen proporcionado. Por ejemplo, una aplicación puede usar esta función para determinar uno o varios formatos PCM válidos a los que se puede descomprimir un formato comprimido.

Sintaxis

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

Parámetros

had

Identificador de una instancia abierta de un controlador para consultar un formato de destino sugerido. Si este parámetro es NULL, el ACM intenta encontrar el mejor controlador para sugerir un formato de destino.

pwfxSrc

Puntero a una estructura WAVEFORMATEX que identifica el formato de origen para el que el controlador ACM o el controlador especificado sugerirán un formato de destino.

pwfxDst

Puntero a una estructura WAVEFORMATEX que recibirá el formato de destino sugerido para el formato pwfxSrc . Según el parámetro fdwSuggest , algunos miembros de la estructura a los que apunta pwfxDst pueden requerir inicialización.

cbwfxDst

Tamaño, en bytes, disponible para el formato de destino. 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).

fdwSuggest

Marcas para que coincidan con el formato de destino deseado. Se definen los valores siguientes.

Valor	Significado
ACM_FORMATSUGGESTF_NCHANNELS	El miembro nChannels de la estructura a la que apunta pwfxDst es válido. El ACM consultará los controladores instalados aceptables que pueden sugerir un formato de destino que coincida con nChannels o produzca un error.
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	El miembro nSamplesPerSec de la estructura a la que apunta pwfxDst es válido. El ACM consultará los controladores instalados aceptables que pueden sugerir un formato de destino que coincida con nSamplesPerSec o que produzca un error.
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	El miembro wBitsPerSample de la estructura a la que apunta pwfxDst es válido. El ACM consultará los controladores instalados aceptables que pueden sugerir un formato de destino que coincida con wBitsPerSample o producirá un error.
ACM_FORMATSUGGESTF_WFORMATTAG	El miembro wFormatTag de la estructura a la que apunta pwfxDst es válido. El ACM consultará los controladores instalados aceptables que pueden sugerir un formato de destino que coincida con wFormatTag o produzca un error.

Valor devuelto

Devuelve cero si es correcto o si se produce un error de lo contrario. Entre los posibles valores de error se incluyen los siguientes.

Código devuelto	Descripción
MMSYSERR_INVALFLAG	Al menos una marca no es válida.
MMSYSERR_INVALHANDLE	El identificador especificado no es válido.
MMSYSERR_INVALPARAM	Al menos un parámetro no es válido.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msacm.h
Library	Msacm32.lib
Archivo DLL	Msacm32.dll

Consulte también

Funciones de compresión de audio

Administrador de compresión de audio

Share via