Функция acmFilterChoose (msacm.h)

Статья
03/05/2024

Функция acmFilterChoose создает диалоговое окно, определяемое ACM, которое позволяет пользователю выбрать фильтр waveform-audio.

Синтаксис

MMRESULT ACMAPI acmFilterChoose(
  LPACMFILTERCHOOSE pafltrc
);

Параметры

pafltrc

Указатель на структуру ACMFILTERCHOOSE , содержащую сведения, используемые для инициализации диалогового окна. Когда возвращается acmFilterChoose , эта структура содержит сведения о выборе фильтра пользователем.

Элемент pwfltr этой структуры должен содержать допустимый указатель на расположение памяти, который будет содержать возвращаемую структуру заголовка фильтра. Член cbwfltr должен быть заполнен размером (в байтах) этого буфера памяти.

Возвращаемое значение

Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата	Описание
ACMERR_CANCELED	Чтобы закрыть диалоговое окно, пользователь нажимает кнопку Отмена или команду Закрыть в меню Система.
ACMERR_NOTPOSSIBLE	Буфер, определенный структурой [ACMFILTERCHOOSE](), слишком мал, чтобы содержать выбранный фильтр.
MMSYSERR_INVALFLAG	По крайней мере один флаг недопустим.
MMSYSERR_INVALHANDLE	Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM	По крайней мере один параметр недопустим.
MMSYSERR_NODRIVER	Подходящий драйвер недоступен для предоставления допустимых фильтров.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	msacm.h
Библиотека	Msacm32.lib
DLL	Msacm32.dll

См. также раздел

Функции сжатия звука

Диспетчер сжатия аудио

Поделиться через