Функция acmDriverMessage (msacm.h)

Статья
08/24/2023

Функция acmDriverMessage отправляет пользовательское сообщение заданному экземпляру драйвера ACM.

Синтаксис

LRESULT ACMAPI acmDriverMessage(
  HACMDRIVER had,
  UINT       uMsg,
  LPARAM     lParam1,
  LPARAM     lParam2
);

Параметры

had

Обработка экземпляра драйвера ACM, в который будет отправлено сообщение.

uMsg

Сообщение, которое должен обработать драйвер ACM. Это сообщение должно находиться в диапазоне сообщений ACMDM_USER (выше или равно ACMDM_USER и меньше ACMDM_RESERVED_LOW). Исключениями из этого ограничения являются сообщения ACMDM_DRIVER_ABOUT, DRV_QUERYCONFIGURE и DRV_CONFIGURE .

lParam1

Параметр сообщения.

lParam2

Параметр сообщения.

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

Возвращаемое значение зависит от определяемого пользователем сообщения драйвера ACM, заданного параметром uMsg. Однако возможные значения ошибок включают следующие.

Код возврата	Описание
MMSYSERR_INVALHANDLE	Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM	Параметр uMsg не находится в диапазоне ACMDM_USER.
MMSYSERR_NOTSUPPORTED	Драйвер ACM не обработал сообщение.

Чтобы отобразить настраиваемое диалоговое окно О программе из драйвера ACM, приложение должно отправить ACMDM_DRIVER_ABOUT сообщение драйверу. Параметр lParam1 должен быть дескриптором окна владельца для настраиваемого диалогового окна О программе, а параметру lParam2 должно быть присвоено значение 0. Если драйвер не поддерживает настраиваемое диалоговое окно О программе, возвращается MMSYSERR_NOTSUPPORTED, и приложение отвечает за отображение собственного диалогового окна. Например, если драйвер ACM возвращает MMSYSERR_NOTSUPPORTED, параметр панель управления звукового сопоставителя отображает диалоговое окно по умолчанию О программе на основе структуры ACMDRIVERDETAILS. Приложение может запрашивать у драйвера поддержку настраиваемого диалогового окна "О программе", не отображая диалоговое окно, задав для lParam1 значение –1l. Если драйвер поддерживает настраиваемое диалоговое окно О программе, возвращается MMSYSERR_NOERROR. В противном случае возвращаемое значение будет MMSYSERR_NOTSUPPORTED.

Определяемые пользователем сообщения должны отправляться только драйверу ACM, который специально поддерживает сообщения. Вызывающий объект должен убедиться, что драйвер ACM является правильным драйвером, извлекая сведения о драйвере и проверив элементы wMid, wPid и vdwDriver структуры ACMDRIVERDETAILS .

Никогда не отправляйте пользовательские сообщения в неизвестный драйвер ACM.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	msacm.h
Библиотека	Msacm32.lib
DLL	Msacm32.dll

См. также раздел

Функции сжатия звука

Диспетчер сжатия аудио