Функция обратного вызова ACMFILTERENUMCBW (msacm.h)
Функция acmFilterEnumCallback указывает функцию обратного вызова, используемую с функцией acmFilterEnum. Имя acmFilterEnumCallback является заполнителем для имени определяемой приложением функции.
Синтаксис
ACMFILTERENUMCBW Acmfilterenumcbw;
BOOL Acmfilterenumcbw(
HACMDRIVERID hadid,
LPACMFILTERDETAILSW 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 | Драйвер поддерживает аппаратные входные данные, выходные данные или оба с указанным фильтром через звуковое устройство волны. Приложение должно использовать функцию acmMetrics с ACM_METRIC_HARDWARE_WAVE_INPUT и ACM_METRIC_HARDWARE_WAVE_OUTPUT индексами метрик, чтобы получить идентификаторы звукового устройства, связанные с вспомогательным драйвером ACM. |
Возвращаемое значение
Функция обратного вызова должна возвращать TRUE, чтобы продолжить перечисление или FALSE, чтобы остановить перечисление.
Замечания
Функция acmFilterEnum вернет MMSYSERR_NOERROR (ноль), если фильтры не будут перечисляться. Кроме того, функция обратного вызова не будет вызываться.
Следующие функции не должны вызываться из функции обратного вызова: acmDriverAdd, acmDriverRemoveи acmDriverPriority.
Заметка
Заголовок msacm.h определяет ACMFILTERENUMCB как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | msacm.h |