функция acmFilterChooseA (msacm.h)

Статья
11/20/2024

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

Синтаксис

MMRESULT ACMAPI acmFilterChooseA(
  LPACMFILTERCHOOSEA pafltrc
);

Параметры

pafltrc

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

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

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

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

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

Замечания

Заметка

Заголовок msacm.h определяет ACMFILTERCHOOSE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	msacm.h
библиотеки	Msacm32.lib
DLL	Msacm32.dll

См. также

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

диспетчер сжатия звука

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