команда MCI_PLAY

Команда MCI_PLAY сообщает устройству о начале передачи выходных данных. Эта команда распознана на компакт-дисках, цифровом видео, midI sequencer, videodisc, VCR и waveform-audio устройствах.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PLAY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_PLAY_PARMS ) lpPlay
);

Параметры

wDeviceID

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

Dwflags

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

lpPlay

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

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

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

Комментарии

Следующие дополнительные флаги применяются ко всем устройствам, поддерживающим MCI_PLAY:

MCI_FROM

Начальное расположение включается в элемент dwFrom структуры, определяемой lpPlay. Единицы измерения, назначенные значениям позиций, указываются с помощью флага MCI_SET_TIME_FORMAT команды MCI_SET . Если MCI_FROM не указан, в качестве начального расположения по умолчанию используется текущая позиция.

MCI_TO

Конечное расположение включается в элемент dwTo структуры, определяемой lpPlay. Единицы измерения, назначенные значениям позиции, указываются с флагом MCI_SET_TIME_FORMAT MCI_SET. Если MCI_TO не указан, в конечном расположении по умолчанию используется конец носителя.

Следующие дополнительные флаги используются с типом устройства digitalvideo :

MCI_DGV_PLAY_REPEAT

Воспроизведение должно начинаться снова в начале по достижении конца содержимого.

MCI_DGV_PLAY_REVERSE

Воспроизведение должно происходить в обратном порядке.

MCI_MCIAVI_PLAY_WINDOW

Воспроизведение должно происходить в окне, связанном с экземпляром устройства (по умолчанию). (Этот флаг предназначен для MCIAVI. DRV.)

MCI_MCIAVI_PLAY_FULLSCREEN

При воспроизведении должен использоваться полноэкранный дисплей. Используйте этот флаг только при воспроизведении сжатых или 8-разрядных файлов.

Для цифровых видеоустройств lpPlay указывает на структуру MCI_DGV_PLAY_PARMS .

Следующие дополнительные флаги используются с типом устройства vcr :

MCI_VCR_PLAY_AT

Элемент dwAt структуры, определяемой lpPlay , содержит время, когда начинается вся команда, или, если устройство указано, когда устройство достигает позиции from, заданной командой MCI_CUE .

MCI_VCR_PLAY_REVERSE

Воспроизведение должно происходить в обратном порядке.

MCI_VCR_PLAY_SCAN

Воспроизведение должно выполняться как можно быстрее при сохранении вывода видео.

Для устройств VCR lpPlay указывает на MCI_VCR_PLAY_PARMS структуру.

Следующие дополнительные флаги используются с типом устройства videodisc :

MCI_VD_PLAY_FAST

Играйте быстро.

MCI_VD_PLAY_REVERSE

Играйте в обратном направлении.

MCI_VD_PLAY_SCAN

Быстрая проверка.

MCI_VD_PLAY_SLOW

Играйте медленно.

MCI_VD_PLAY_SPEED

Скорость воспроизведения включается в элемент dwSpeed в структуре, определяемой lpPlay.

Требования

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

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

MCI

Команды MCI