Función acmFilterChooseA (msacm.h)
La función acmFilterChoose crea un cuadro de diálogo definido por ACM que permite al usuario seleccionar un filtro de audio de forma de onda.
Sintaxis
MMRESULT ACMAPI acmFilterChooseA(
LPACMFILTERCHOOSEA pafltrc
);
Parámetros
pafltrc
Puntero a una estructura ACMFILTERCHOOSE que contiene información utilizada para inicializar el cuadro de diálogo. Cuando devuelve acmFilterChoose , esta estructura contiene información sobre la selección de filtros del usuario.
El miembro pwfltr de esta estructura debe contener un puntero válido a una ubicación de memoria que contendrá la estructura de encabezado de filtro devuelta. El miembro cbwfltr debe rellenarse con el tamaño, en bytes, de este búfer de memoria.
Valor devuelto
Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles 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 la estructura [ACMFILTERCHOOSE](./nf-msacm-acmfilterchoose.md) es demasiado pequeño para contener el filtro 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 filtro válidas. |
Comentarios
Nota:
El encabezado msacm.h define ACMFILTERCHOOSE como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
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 |