Функция обратного вызова ACMFILTERENUMCB (msacm.h)
Функция acmFilterEnumCallback указывает функцию обратного вызова, используемую с функцией acmFilterEnum . Имя acmFilterEnumCallback является заполнителем для имени определяемой приложением функции.
Синтаксис
ACMFILTERENUMCB Acmfilterenumcb;
BOOL Acmfilterenumcb(
HACMDRIVERID hadid,
LPACMFILTERDETAILS 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 , чтобы остановить перечисление.
Комментарии
Функция acmFilterEnum возвращает MMSYSERR_NOERROR (ноль), если не требуется перечисление фильтров. Кроме того, функция обратного вызова вызываться не будет.
Из функции обратного вызова не следует вызывать следующие функции: acmDriverAdd, acmDriverRemove и acmDriverPriority.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | msacm.h |