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

Статья
11/20/2024

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

Синтаксис

ACMFORMATENUMCBA Acmformatenumcba;

BOOL Acmformatenumcba(
  HACMDRIVERID hadid,
  LPACMFORMATDETAILSA pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Параметры

hadid

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

pafd

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

dwInstance

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

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, чтобы остановить перечисление.

Замечания

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

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

Заметка

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

Требования

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

См. также

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

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

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