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 |
|---|---|
|
Al menos una marca no es válida. |
|
El identificador especificado no es válido. |
|
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 |