Función acmFormatChoose (msacm.h)
La función acmFormatChoose crea un cuadro de diálogo definido por ACM que permite al usuario seleccionar un formato de audio de forma de onda.
Sintaxis
MMRESULT ACMAPI acmFormatChoose(
LPACMFORMATCHOOSE pafmtc
);
Parámetros
pafmtc
Puntero a una estructura ACMFORMATCHOOSE que contiene información utilizada para inicializar el cuadro de diálogo. Cuando se devuelve esta función, esta estructura contiene información sobre la selección de formato del usuario.
El miembro pwfx de esta estructura debe contener un puntero válido a una ubicación de memoria que contendrá la estructura de encabezado de formato devuelta. Además, el miembro cbwfx debe rellenarse con el tamaño, en bytes, de este búfer de memoria.
Valor devuelto
Devuelve MMSYSERR_NOERROR si se ejecuta correctamente o si se produce un error. Entre los posibles valores devueltos se incluyen los siguientes.
| Código devuelto | Descripción |
|---|---|
|
El usuario eligió el botón Cancelar o el comando Cerrar en el menú Sistema para cerrar el cuadro de diálogo. |
|
El búfer identificado por el miembro pwfx de la estructura ACMFORMATCHOOSE es demasiado pequeño para contener el formato seleccionado. |
|
Al menos una marca no es válida. |
|
El identificador especificado no es válido. |
|
Al menos un parámetro no es válido. |
|
Un controlador adecuado no está disponible para proporcionar selecciones de formato válidas. |
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 |