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

Статья
08/24/2023

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

Синтаксис

ACMFILTERENUMCBA Acmfilterenumcba;

BOOL Acmfilterenumcba(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILSA pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Параметры

hadid

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

pafd

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

dwInstance

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

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 индексы метрик, чтобы получить идентификаторы устройств waveform-audio, связанные с поддерживающим драйвером ACM.

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

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

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

Требования

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

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

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

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

Share via