Функция acmDriverMessage (msacm.h)
Функция 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. Однако возможные значения ошибок включают следующие.
| Код возврата | Описание |
|---|---|
|
Указанный дескриптор недопустим. |
|
Параметр uMsg не находится в диапазоне ACMDM_USER. |
|
Драйвер 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 |