Команда save

Статья
06/13/2023

Команда сохранения сохраняет 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
Захвата
Заповедник