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

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

Синтаксис

ACMFILTERTAGENUMCB Acmfiltertagenumcb;

BOOL Acmfiltertagenumcb(
  HACMDRIVERID hadid,
  LPACMFILTERTAGDETAILS paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Параметры

hadid

Дескриптор идентификатора драйвера ACM.

paftd

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

dwInstance

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

fdwSupport

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

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

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

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

Комментарии

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

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

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header msacm.h

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

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

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