AcmFilterEnumCallback

BOOL ACMFILTERENUMCB acmFilterEnumCallback( HACMDRIVERID hadid, LPACMFILTERDETAILS pafd, DWORD dwInstance, DWORD fdwSupport );

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

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

Аргументы

0. hadid — дескриптор идентификатора драйвера ACM.

1. pafd — указатель на объект структуры ACMFILTERDETAILS, содержащий информацию по искомому фильтру.

2. dwInstance — переменная, определяемая в функции acmFilterEnum, значение которой зависит от приложения.

3. fdwSupport— флаги поддержки драйверов, назначение которых зависит от драйвера, определяемого аргументом hadid. Значение этого аргумента соответствует значению переменной 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 — драйвер позволяет производить аппаратный ввод, вывод или одновременный ввод и вывод через аудио устройство. Для получения идентификаторов устройств, связанных с поддерживаемым драйвером ACM приложение должно вызвать функцию acmMetricsс индексами метрики ACM_METRIC_HARDWARE_WAVE_INPUT и ACM_METRIC_HARDWARE_WAVE_OUTPUT.

Примечание

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

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

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

Описание данной функции содержится в файле заголовка msacm.h.

AcmFilterTagEnum

MMRESULT acmFilterTagEnum( HACMDRIVER had, LPACMFILTERTAGDETAILS paftd, ACMFILTERTAGENUMCB fnCallback, DWORD dwInstance, DWORD fdwEnum );

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

В случае успешного завершения возвращает нулевое значение. В противном случае возвращает одно из следующих значений:

• MMSYSERR_INVALFLAG — при вызове данной функции установлен, по крайней мере, один недопустимый флаг.

• MMSYSERR_INVALHANDLE — использован недопустимый дескриптор.

• MMSYSERR_INVALPARAM — при вызове данной функции, по крайней мере, один из её аргументов имеет недопустимое значение.

Аргументы

0. had — дескриптор драйвера ACM, для которого следует получить информацию о типе аудио фильтров. Если этот аргумент имеет нулевое значение, ACM передаёт информацию, касающуюся первого драйвера ACM, соответствующего выдвинутым требованиям.

1. paftd — указатель на объект структуры ACMFILTERTAGDETAILS, содержащий описание типа фильтра, передаваемого функции, определённой в аргументе fnCallback. При вызове в приложении функции acmFilterTagEnum в данном объекте структуры должна быть инициализирована переменная cbStruct.

2. fnCallback — указатель на экземпляр процедуры, определённой приложением в качестве функции обратного вызова.

3. dwInstance — определяемая в приложении 32-разрядная величина, передаваемая в качестве аргумента функции обратного вызова вместе с информацией о типе фильтра ACM.

4. fdwEnum — зарезервирован для дальнейшего использования и должен иметь нулевое значение.

Примечание

Функция acmFilterTagEnum производит поиск по типу аудио фильтра, используемого в драйвере ACM. Поиск завершается после просмотра всех имеющихся типов фильтров или в том случае, когда функция обратного вызова возвращает значение FALSE.

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

Описание данной функции содержится в файле заголовка msacm.h. При работе с данной функцией следует включить в проект библиотеку msacm32.lib.