Share via

MM_MCINOTIFY сообщение

  • Статья

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

MM_MCINOTIFY 
wParam = (WPARAM) wFlags 
lParam = (LONG) lDevID

Параметры

wFlags

Причина уведомления. Определяются следующие значения:

Требование Значение
MCI_NOTIFY_ABORTED Устройство получило команду, которая не позволила выполнить текущие условия для инициации функции обратного вызова. Если новая команда прерывает текущую команду и запрашивает уведомление, устройство отправляет только это сообщение, а не MCI_NOTIFY_SUPERSEDED
MCI_NOTIFY_FAILURE Произошла ошибка устройства, когда устройство выполняло команду.
MCI_NOTIFY_SUCCESSFUL Выполнены условия, инициирующие функцию обратного вызова.
MCI_NOTIFY_SUPERSEDED Устройство получило еще одну команду с установленным флагом "уведомлять", а текущие условия для инициации функции обратного вызова заменены.

lDevID

Идентификатор устройства, инициирующего функцию обратного вызова.

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

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

Комментарии

Дополнительные сведения о флаге MCI_NOTIFY см. в разделе Флаг уведомления.

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

Устройство возвращает флаг MCI_NOTIFY_ABORTED с MM_MCINOTIFY только при получении команды, препятствующей выполнению условий уведомления. Например, команда воспроизведения не прерывает уведомление для предыдущей команды воспроизведения при условии, что новая команда не изменяет направление воспроизведения или не изменяет конечную позицию. Команды поиска и записи ведут себя аналогично. MCI также не отправляет MCI_NOTIFY_ABORTED при приостановке воспроизведения или записи с помощью команды pause ( MCI_PAUSE). Отправка команды resume ( MCI_RESUME) позволяет им продолжать выполнять условия обратного вызова.

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

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Mmsystem.h (включая Windows.h)

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

MCI

Сообщения MCI

Пауза

играть

Записи

Возобновить

Искать