Команда save

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

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

_stprintf_s(
  lpszCommand, 
  TEXT("save %s %s %s"), 
  lpszDeviceID, 
  lpszFilename, 
  lpszFlags
); 

Параметры

lpszDeviceID

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

lpszFilename

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

Значение Значение Значение
digitalvideo прерывание в прямоугольнике filenamekeepreserve
overlay в прямоугольнике filename
sequencer filename
waveaudio filename

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

Значение Значение
abort Останавливает выполнение операции сохранения . Если используется, это должен быть единственный элемент.
в прямоугольнике Задает прямоугольник относительно источника буфера кадра. Прямоугольник указан как X1 Y1 X2 Y2. Координаты X1 Y1 указывают верхний левый угол, а координаты X2 Y2 — ширину и высоту. Для цифровых видеоустройств команда захвата используется для записи содержимого буфера кадров.
filename Указывает имя файла, назначаемого файлу данных. Если путь не указан, файл будет помещен на диск и в каталог, ранее указанный в явной или неявной команде резервирования . Если резервирование не было выдано, диск и каталог по умолчанию связаны с задачей приложения. Если указан путь, устройство может потребовать, чтобы оно было на диске, указанном явным или неявным резервом. Этот флаг является обязательным.
keepreserve Указывает, что неиспользуемое дисковое пространство, оставшееся от исходной команды резервирования , не освобождается.

lpszFlags

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

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

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

Комментарии

Переменная имени файла является обязательной, если устройство было открыто с помощью "нового" идентификатора устройства.

Примеры

Следующая команда сохраняет весь буфер видео в файл с именем VCAPFILE. TGA.

save vboard c:\vcap\vcapfile.tga

Требования

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

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

MCI

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

Захвата

Заповедник