AcmDriverProc

LRESULT CALLBACK acmDriverProc( DWORD dwID, HDRIVER hdrvr, UINT uMsg, LPARAM lParam1, LPARAM lParam2 );

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

В случае успешного завершения возвращает нулевое значение. В противном случае возвращается значение ошибки.

Аргументы

0. dwID — идентификатор инсталлируемого драйвера ACM.

1. hdrvr — дескриптор инсталлируемого драйвера ACM. В этом аргументе передаётся уникальный дескриптор, назначаемый драйверу ACM.

2. uMsg — сообщение драйверу ACM.

3. lParam1 и lParam2 — аргументы сообщения.

Примечание

Функция acmDriverProc представляет собой функцию обратного вызова, используемую драйвером ACM. Имя функции acmDriverProc является условным и может быть заменено любым именем, не используемым другими функциями. Действительное имя данной функции должно экспортироваться при включении его в файл описания модуля исполнительного файла или файла библиотеки динамической компоновки (DLL).

Приложение не может вызывать системные функции из функции обратного вызова, за исключением следующих функций: PostMessage, timeGetSystemTime, timeGetTime, timeSetEvent, timeKillEvent, midiOutShortMsg, midiOutLongMsg и OutputDebugStr.

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

AcmDriverRemove

MMRESULT acmDriverRemove( HACMDRIVERID hadid, DWORD fdwRemove );

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

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

• MMSYSERR_ALLOCATED — отложенный запрет на посылку сообщений принадлежит другой задаче.

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

• ACMERR_BUSY — указанный драйвер используется и не может быть удалён.

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

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

Аргументы

0. hadid — дескриптор идентификатора удаляемого драйвера.

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

Примечание

Функция acmDriverRemove удаляет драйвер из списка установленных драйверов ACM. Драйвер удаляется только из списка вызвавшего эту функцию приложения. Если драйвер установлен глобально, другие приложения могут продолжать его использовать.

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

AcmFilterChoose

MMRESULT acmFilterChoose( LPACMFILTERCHOOSE pafltrc );

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

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

• ACMERR_CANCELED — пользователь нажал кнопку Cancel в диалоговом окне или выбрал команду Закрыть в системном меню диалогового окна.

• ACMERR_NOTPOSSIBLE — буфер, на который указывает переменная pwfltr объекта структуры ACMFILTERCHOOSE, имеет недостаточный размер, чтобы вместить в себя описание выделенного формата.

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

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

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

• MMSYSERR_NODRIVER — отсутствует драйвер, позволяющий работать с указанным фильтром.

Аргументы

0. pafltrc — указатель на объект структуры ACMFILTERCHOOSE содержащий информацию, используемую при инициализации диалогового окна. После завершения работы функции acmFilterChoose в этом объекте структуры содержится информация о выбранном пользователем фильтре.

1. Перед вызовом данной функции в переменной pwfltr объекта структуры ACMFILTERCHOOSE должен содержаться корректный указатель на область памяти, в которую будет помещён объект структуры дескриптора возвращаемого фильтра. В переменной cbwfltr данного объекта структуры должен содержаться размер этой области памяти в байтах.

Примечание

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

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