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

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

  • Статья

Функция 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
 По крайней мере один параметр недопустим.

Комментарии

Эта функция возвращает MMSYSERR_NOERROR (ноль), если не установлены подходящие драйверы ACM. Кроме того, функция обратного вызова вызываться не будет.

Требования

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

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

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

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