Функция acmFilterEnum (msacm.h)
Функция acmFilterEnum перечисляет фильтры waveform-audio, доступные для заданного тега фильтра из драйвера ACM. Эта функция продолжает перечисление, пока не будет больше подходящих фильтров для тега фильтра или функция обратного вызова не вернет значение FALSE.
Синтаксис
MMRESULT ACMAPI acmFilterEnum(
HACMDRIVER had,
LPACMFILTERDETAILS pafd,
ACMFILTERENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Параметры
had
Выполните запрос к драйверу ACM для запроса сведений о фильтре waveform-audio. Если этот параметр имеет значение NULL, ACM использует сведения из первого подходящего драйвера ACM.
pafd
Указатель на структуру ACMFILTERDETAILS , которая содержит сведения о фильтре при передаче в функцию, заданную fnCallback. Когда приложение вызывает acmFilterEnum, необходимо инициализировать члены cbStruct, pwfltr и cbwfltr этой структуры. Член dwFilterTag также должен быть инициализирован WAVE_FILTER_UNKNOWN или допустимым тегом фильтра.
fnCallback
Адрес экземпляра процедуры функции обратного вызова, определяемой приложением.
dwInstance
32-разрядное (DWORD), 64-разрядное (DWORD_PTR) значение, определяемое приложением, которое передается в функцию обратного вызова вместе со сведениями о фильтре ACM.
fdwEnum
Флаги для перечисления фильтров для заданного тега фильтра. Определены следующие значения.
[ACMFILTERDETAILS] (./nf-msacm-acmfilterdetails.md) является допустимой структурой. Перечислитель перечисляет только фильтр, соответствующий этому атрибуту. Член dwFilterTag структуры ACMFILTERDETAILS должен быть равен члену dwFilterTag структуры WAVEFILTER .| Значение | Значение |
|---|---|
| ACM_FILTERENUMF_DWFILTERTAG |
Возвращаемое значение
Возвращает ноль в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Не удается вернуть сведения о фильтре. |
|
По крайней мере один флаг недопустим. |
|
Указанный дескриптор недопустим. |
|
По крайней мере один параметр недопустим. |
Комментарии
Функция acmFilterEnum возвращает MMSYSERR_NOERROR (ноль), если подходящие драйверы ACM не установлены. Кроме того, функция обратного вызова вызываться не будет.
Из функции обратного вызова не следует вызывать следующие функции: acmDriverAdd, acmDriverRemove и acmDriverPriority.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | msacm.h |
| Библиотека | Msacm32.lib |
| DLL | Msacm32.dll |