Функция обратного вызова 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 |