Функция обратного вызова ACMFORMATTAGENUMCBW (msacm.h)

Статья
11/20/2024

Функция acmFormatTagEnumCallback указывает функцию обратного вызова, используемую с функцией acmFormatTagEnum. имя acmFormatTagEnumCallback является заполнителем для имени определяемой приложением функции.

Синтаксис

ACMFORMATTAGENUMCBW Acmformattagenumcbw;

BOOL Acmformattagenumcbw(
  HACMDRIVERID hadid,
  LPACMFORMATTAGDETAILSW paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Параметры

hadid

Обработка идентификатора драйвера ACM.

paftd

Указатель на структуру ACMFORMATTAGDETAILS, содержащую сведения о теге перечисленного формата.

dwInstance

Определяемое приложением значение, указанное в функции acmFormatTagEnum.

fdwSupport

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

Ценность	Значение
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Драйвер поддерживает асинхронные преобразования с указанным тегом фильтра.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Драйвер поддерживает преобразование между двумя различными тегами формата, где один из тегов является указанным тегом формата. Например, если драйвер поддерживает сжатие от WAVE_FORMAT_PCM до WAVE_FORMAT_ADPCM, этот флаг устанавливается.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Драйвер поддерживает преобразование между двумя различными форматами указанного тега формата. Например, если драйвер поддерживает изменение размера WAVE_FORMAT_PCM, этот флаг устанавливается.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Драйвер поддерживает фильтр (изменение данных без изменения атрибутов формата). Например, если драйвер поддерживает операции тома или эхо с указанным тегом формата, этот флаг устанавливается.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Драйвер поддерживает аппаратные входные данные, выходные данные или оба указанного тега формата с помощью звукового устройства waveform-audio. Приложение должно использовать метрик acmMetrics с ACM_METRIC_HARDWARE_WAVE_INPUT и ACM_METRIC_HARDWARE_WAVE_OUTPUT индексами метрик, чтобы получить идентификаторы устройства waveform-audio, связанные с вспомогательным драйвером ACM.

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

Функция обратного вызова должна возвращать TRUE, чтобы продолжить перечисление или FALSE, чтобы остановить перечисление.

Замечания

Функция acmFormatTagEnum вернет MMSYSERR_NOERROR (ноль), если теги формата не перечисляются. Кроме того, функция обратного вызова не будет вызываться.

Следующие функции не должны вызываться из функции обратного вызова: acmDriverAdd, acmDriverRemoveи acmDriverPriority.

Заметка

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

Требования

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

См. также

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

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

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