Команда record

Команда record запускает запись данных. Устройства VCR и waveform-audio распознают эту команду. Хотя цифровые видеоустройства и секвенсоры MIDI также распознают эту команду, драйверы MCIAVI и MCISEQ не реализуют ее.

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

_stprintf_s(
  lpszCommand, 
  TEXT("record %s %s %s"), 
  lpszDeviceID, 
  lpszRecordFlags, 
  lpszFlags
); 

Параметры

lpszDeviceID

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

lpszRecordFlags

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

Значение Значение Значение
digitalvideo в потокеаудиопотока прямоугольникаиз позицииудержания Вставка перезаписи для размещениявидеопотока
sequencer вставка из позиции перезаписать на позицию
Видео в моментвремени с позиции инициализация insert overwrite to position
waveaudio вставка из позиции перезаписать на позицию

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

Значение Значение
в прямоугольнике Задает прямоугольную область внешних входных данных, используемых в качестве источника для сжатых и сохраненных пикселей. Если значение не указано, по умолчанию используется прямоугольник, указанный для параметра put "video". Если оно задается иначе, чем в прямоугольнике "видео", отображаемое изображение не записывается.
в то время Указывает, когда устройство должно начать выполнение этой команды или, если устройство было объявлено, когда начинается команда cued. Дополнительные сведения см. в разделе Команда подсказки .
поток аудиопотока Указывает аудиопоток, используемый для записи. Если этот флаг не указан, а формат файла не определяет значение по умолчанию, он записывается в поток, который физически является первым.
с позиции Задает начальную позицию записи. Если флаг "from" не указан, устройство начинает запись в текущей позиции.
Держать Замораживает изображение после завершения записи вместо отображения видеотрансляции. При остановке записи выполняется автоматическая команда "файл" монитора . Чтобы вернуться к видеотрансляции, выполните команду "ввод" монитора .
Инициализации Инициализируйте ленту (носитель), которая включает запись таймкода (если это возможно) для пустого видео и звука. Эта команда может занять несколько часов, если требуется инициализировать всю ленту.
insert Указывает, что новые данные добавляются в файл в текущей позиции.
перезапись Указывает, что новые данные заменят данные в файле.
на позицию Указывает конечную позицию записи. Если флаг "to" не указан, устройство записывает данные, пока не получит команду stop или pause .
поток видеопотока Указывает видеопоток, используемый для записи. Если этот параметр не указан и формат файла не определяет значение по умолчанию, он записывается в поток, который физически является первым.

lpszFlags

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

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

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

Комментарии

Запись останавливается при выполнении команды stop или pause . Для драйвера MCIWAVE все данные, записанные после открытия файла, удаляются, если файл закрыт без сохранения.

Перед выполнением команд, использующих значения позиций, необходимо задать нужный формат времени с помощью команды set . Записываемые дорожки задаются командами settimecode "record", set "сбор записи", setvideo "record" и setaudio "record".

Примеры

Следующая команда запускает запись в текущей позиции.

record mysound

Требования

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

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

MCI

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

Cue

monitor

pause

Положить

set

setaudio

settimecode

setvideo

stop