Compartir a través de


Función acmFormatSuggest (msacm.h)

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