AcmFilterChooseHookProc

UINT ACMFILTERCHOOSEHOOKPROC acmFilterChooseHookProc( HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam );

Аргументы

0. hwnd — дескриптор диалогового окна.

1. uMsg — сообщение, посылаемое процедуре окна.

2. wParam и lParam — аргументы сообщения.

Примечание

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

Для обработки выбора элементов управления диалогового окна данная функция может обрабатывать сообщение MM_ACM_FILTERCHOOSE.

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

AcmFilterEnum

MMRESULT acmFilterEnum( HACMDRIVER had, LPACMFILTERDETAILS pafd, ACMFILTERENUMCB fnCallback, DWORD dwInstance, DWORD fdwEnum );

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

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

• ACMERR_NOTPOSSIBLE — информация о фильтре не может быть получена.

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

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

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

Аргументы

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

1. pafd — указатель на объект структуры ACMFILTERDETAILS, содержащей описание фильтра, передаваемого функции, определённой в аргументе fnCallback. При вызове в приложении функции acmFilterEnum в данном объекте структуры должны быть инициализированы переменные cbStruct, pwfltr и cbwfltr. Если установлен флаг WAVE_FILTER_UNKNOWN или передаётся корректный тип фильтра, необходимо, также, инициализировать переменную dwFilterTag данного объекта структуры.

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

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

4. fdwEnum — флаги, определяющие режим поиска по указному типу фильтра. Определены следующие значения:

• ACM_FILTERENUMF_DWFILTERTAG — переменная dwFilterTag объекта структуры WAVEFILTER, на который указывает переменная pwfltr объекта структуры ACMFILTERDETAILS, содержит корректное значение. Производится поиск фильтров, соответствующих данному параметру. Значение переменной pwfltr объекта структуры ACMFILTERDETAILS должно соответствовать значению переменной dwFilterTag объекта структуры WAVEFILTER.

Примечание

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

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

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

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