Función acmFilterChoose (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 acmFilterChoose(
LPACMFILTERCHOOSE 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]() 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. |
Requisitos
| Requisito | Value |
|---|---|
| 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 |