Команда воспроизведения

Команда воспроизведения запускает воспроизведение устройства. Эта команда распознает аудиозаписи, цифровое видео, midi sequencer, videodisc, VCR и waveform-audio устройства.

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

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
); 

Параметры

lpszDeviceID

Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.

lpszPlayFlags

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

Значение	Значение	Значение
cdaudio	с позиции	на позицию
digitalvideo	с позицииполноэкранного повтора	обратное положениеокна
sequencer	с позиции	на позицию
Видео	в моментвремени с обратного положения	сканировать на позицию
videodisc	быстрое обратное сканирование позиции	медленное целое числоскорости для позиции
waveaudio	с позиции	на позицию

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

Значение	Значение
в то время	Указывает, когда устройство должно приступить к выполнению этой команды или, если устройство было объявлено, при запуске команды cued. Дополнительные сведения см. в разделе Команда cue .
быстрая	Указывает, что устройство должно играть быстрее, чем обычно. Чтобы определить точную скорость проигрывателя видеодисков, используйте флаг "скорость" команды состояния . Чтобы точнее указать скорость, используйте флаг "скорость" этой команды.
с позиции	Задает начальную позицию для воспроизведения. Если флаг "from" не указан, воспроизведение начинается с текущей позиции. Для устройств cdaudio , если позиция "from" больше конечной позиции диска или позиция "from" больше позиции "to", драйвер возвращает ошибку. Для устройств с видеодисками позиции по умолчанию находятся в кадрах для дисков CAV и в часах, минутах и секундах для дисков CLV.
полноэкранный	Указывает, что должен использоваться полноэкранный дисплей. Используйте этот флаг только при воспроизведении сжатых файлов. (Несжатые файлы не будут воспроизводиться в полноэкранном режиме.)
repeat	Указывает, что воспроизведение должно перезапускаться при достижении конца содержимого.
reverse	Указывает, что направление воспроизведения находится в обратном направлении. Вы не можете указать конечное расположение с флагом "обратный". Для видеодисков "сканирование" применяется только к формату CAV.
scan	Воспроизводится как можно быстрее, не отключая видео (хотя звук может быть отключен). Для видеодисков "сканирование" применяется только к формату CAV.
медленный	Играет медленно. Чтобы определить точную скорость проигрывателя видеодисков, используйте флаг "скорость" команды состояния . Чтобы точнее указать скорость, используйте флаг "скорость" этой команды. Для видеодисков "медленный" применяется только к формату CAV.
целое число скорости	Воспроизводит видеодиск с указанной скоростью в кадрах в секунду. Этот флаг применяется только к дискам CAV.
на позицию	Указывает конечную позицию для воспроизведения. Если флаг "to" не указан, воспроизведение останавливается в конце содержимого. Для устройств cdaudio , если позиция "to" больше конечной позиции диска, драйвер возвращает ошибку. Для устройств с видеодисками позиции по умолчанию находятся в кадрах для дисков CAV и в часах, минутах и секундах для дисков CLV.
window	Указывает, что при воспроизведении должно использоваться окно, связанное с экземпляром устройства. Это параметр по умолчанию.

lpszFlags

Может иметь значение "wait", "notify" или и то, и другое. Для устройств с цифровым видео и VCR также можно указать test. Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

Комментарии

Перед выполнением команд, использующих значения позиции, необходимо задать нужный формат времени с помощью команды set . Эта команда начинает играть с текущей скоростью, как указано с помощью команды set "speed". Направление является обратным, если указан флаг "обратный" или если флаг "to" указан как значение меньше флага "from". Если флаг "from" не указан, воспроизведение начинается с текущей позиции. Флаги "to" и "reverse" нельзя использовать вместе.

Примеры

Следующая команда воспроизводит устройство mysound от позиции 1000 до позиции 2000, отправляя уведомление по завершении воспроизведения.

play mysound from 1000 to 2000 notify

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]

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

MCI

Командные строки MCI

Cue

set