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

Статья
11/20/2024

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

Синтаксис

MMRESULT ACMAPI acmFormatTagEnumA(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSA paftd,
  ACMFORMATTAGENUMCBA    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. Кроме того, функция обратного вызова не будет вызываться.

Заметка

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

Требования

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

См. также

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

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

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