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

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

Синтаксис

ACMDRIVERENUMCB Acmdriverenumcb;

BOOL Acmdriverenumcb(
  HACMDRIVERID hadid,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Параметры

hadid

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

dwInstance

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

fdwSupport

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

Значение Значение
ACMDRIVERDETAILS_SUPPORTF_ASYNC Драйвер поддерживает асинхронные преобразования.
ACMDRIVERDETAILS_SUPPORTF_CODEC Драйвер поддерживает преобразование между двумя различными тегами формата. Например, если драйвер поддерживает сжатие от WAVE_FORMAT_PCM до WAVE_FORMAT_ADPCM, этот флаг устанавливается.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER Драйвер поддерживает преобразование двух разных форматов одного и того же тега формата. Например, если драйвер поддерживает повторную выборку WAVE_FORMAT_PCM, этот флаг устанавливается.
ACMDRIVERDETAILS_SUPPORTF_DISABLED Драйвер отключен. Чтобы включить отключенные драйверы в перечисление, приложение должно указать флаг ACM_DRIVERENUMF_DISABLED с помощью acmDriverEnum .
ACMDRIVERDETAILS_SUPPORTF_FILTER Драйвер поддерживает фильтр (изменение данных без изменения атрибутов формата). Например, если драйвер поддерживает операции тома или эха в WAVE_FORMAT_PCM, этот флаг устанавливается.

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

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

Комментарии

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

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

Требования

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

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

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

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