Mm_mcinotify

MM_MCINOTIFY

wParam = (WPARAM) wFlags

lParam = (LONG) lDevID

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

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

Аргументы

0. wFlags — причина посылки извещения. Определены следующие значения:

• MCI_NOTIFY_ABORTED — устройство получило команду, противоречащую текущим условиям инициализации функции обратного вызова. Если новая команда прерывает исполнение предыдущей команды, которая должна послать извещение о завершении своей работы, устройство посылает только это сообщение и не посылает сообщения MCI_NOTIFY_SUPERSEDED.

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

• MCI_NOTIFY_SUCCESSFUL — удовлетворены условия инициализации функции обратного вызова.

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

0. lDevID — идентификатор устройства инициализирующего функцию обратного вызова.

Примечание

Сообщение MM_MCINOTIFY извещает приложение о завершении операции на устройстве MCI. Устройства MCI посылают это сообщение только в том случае, если был установлен флаг MCI_NOTIFY.

В случае успешного завершения операции в сообщении MM_MCINOTIFY устанавливается флаг MCI_NOTIFY_SUCCESSFUL. Извещение с этим флагом будет, например, послано в том случае, если лазерный проигрыватель завершит воспроизведение по команде play (MCI_PLAY). Команда play успешно завершает свою работу только в том случае, когда курсор воспроизведения достигает конечной позиции фрагмента или конца носителя информации. Аналогично команды seek (MCI_SEEK) и record (MCI_RECORD) не посылают возвращают флаг MCI_NOTIFY_SUCCESSFUL, пока они не достигнут указанной позиции или конца носителя информации.

В том случае, если устройство получает сообщение, препятствующее ему успешно завершить предыдущую команду, оно посылает сообщение MM_MCINOTIFY с флагом MCI_NOTIFY_ABORTED. Например, новая команда play не вызовет посылки извещения с данным флагом, если она не изменяет направления воспроизведения и конечной позиции, установленных предыдущей командой play. Точно также ведут себя команды seek и record. Это сообщение не посылается также и при получении команды pause (MCI_PAUSE) в процессе записи или воспроизведения, поскольку команда resume (MCI_RESUME) позволит им продолжить операцию и успешно её завершить.

Если приложение требует возврата извещения при посылке команды, то необходимо проверять значения, возвращаемые функциями mciSendString и mciSendCommand, поскольку, если при выполнении данных функций возникнут ошибки, то сообщение не будет отправлено, что приведёт к отсутствию ответного извещения.

Описание данного сообщения содержится в файле заголовка mmsystem.h.

Mm_mcisignal

MM_MCISIGNAL

wParam = (WPARAM) wID

lParam = (LONG) lUserParm

Аргументы

0. wID — идентификатор устройства, пославшего сигнальное сообщение.

1. lUserParm — значение, передаваемое в переменной dwUserParm объекта структуры MCI_DGV_SIGNAL_PARAMS при определении в команде signal её функции обратного вызова. Данный аргумент может также содержать информацию о позиции.

Примечание

Сообщение MM_MCISIGNAL посылается окну для извещения приложения о том, что устройство MCI достигло позиции, определённой в предыдущем вызове команды signal (MCI_SIGNAL).

Описание данного сообщения содержится в файле заголовка mmsystem.h.