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

Статья
02/29/2024

Функция acmFilterTagEnum перечисляет теги фильтра waveform-audio, доступные из драйвера ACM. Эта функция продолжает перечисление до тех пор, пока не не будет более подходящих тегов фильтра или функция обратного вызова не вернет значение FALSE.

Синтаксис

MMRESULT ACMAPI acmFilterTagEnum(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  ACMFILTERTAGENUMCB    fnCallback,
  DWORD_PTR             dwInstance,
  DWORD                 fdwEnum
);

Параметры

had

Выполните запрос к драйверу ACM для запроса сведений о теге фильтра waveform-audio. Если этот параметр имеет значение NULL, ACM использует сведения из первого подходящего драйвера ACM.

paftd

Указатель на структуру ACMFILTERTAGDETAILS , содержащую сведения о теге фильтра при передаче в функцию fnCallback . Когда приложение вызывает acmFilterTagEnum, необходимо инициализировать элемент cbStruct этой структуры.

fnCallback

Адрес экземпляра процедуры функции обратного вызова, определяемой приложением.

dwInstance

64-разрядное (DWORD_PTR) или 32-разрядное (DWORD) значение, определяемое приложением, которое передается в функцию обратного вызова вместе с сведениями о теге фильтра ACM.

fdwEnum

Защищены; значение должно быть равно нулю.

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

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

Код возврата	Описание
MMSYSERR_INVALFLAG	По крайней мере один флаг недопустим.
MMSYSERR_INVALHANDLE	Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM	По крайней мере один параметр недопустим.

Требования

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

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

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

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