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

Статья
08/24/2023

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

Синтаксис

MMRESULT ACMAPI acmFormatTagEnum(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  ACMFORMATTAGENUMCB    fnCallback,
  DWORD_PTR             dwInstance,
  DWORD                 fdwEnum
);

Параметры

had

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

paftd

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

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

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

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

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