команда MCI_STOP

  • Статья

Команда MCI_STOP останавливает все последовательности воспроизведения и записи, выгружает все буферы воспроизведения и прекращает отображение видеоизов. Эта команда распознает аудиозаписи, цифровое видео, midi sequencer, videodisc, VCR и waveform-audio устройства.

Чтобы отправить эту команду, вызовите функцию mciSendCommand со следующими параметрами.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_STOP, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpStop
);

Параметры

wDeviceID

Идентификатор устройства MCI, которое будет получать сообщение команды.

Dwflags

MCI_NOTIFY, MCI_WAIT или для устройств с цифровым видео и VCR MCI_TEST. Сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

lpStop

Указатель на структуру MCI_GENERIC_PARMS . (Устройства с расширенными наборами команд могут заменить эту структуру структурой для конкретного устройства.)

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

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

Комментарии

Разница между командами MCI_STOP и MCI_PAUSE зависит от устройства. Если это возможно, MCI_PAUSE приостанавливает работу устройства, но оставляет устройство готовым к немедленному возобновлению воспроизведения.

Для звукового устройства компакт-диска MCI_STOP сбрасывает текущую позицию дорожки до нуля; в отличие от этого, MCI_PAUSE сохраняет текущее положение трека, предвидя, что устройство возобновит игру.

Требования

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

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

MCI

Команды MCI