команда MCI_SAVE

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

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SAVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SAVE_PARMS ) lpSave
);

Параметры

wDeviceID

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

Dwflags

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

lpSave

Указатель на структуру MCI_SAVE_PARMS . (Устройства с дополнительными параметрами могут заменить эту структуру структурой, относяющейся к устройству.)

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

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

Remarks

Эта команда поддерживается устройствами, возвращающими значение TRUE при вызове команды MCI_GETDEVCAPS с флагом MCI_GETDEVCAPS_CAN_SAVE.

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

MCI_SAVE_FILE

Элемент lpfilename структуры, определяемой lpSave , содержит адрес буфера, содержащего имя целевого файла.

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

MCI_DGV_RECT

Член-кандидат структуры, определяемой lpSave, содержит допустимый прямоугольник. Прямоугольник задает область буфера кадра, который будет сохранен в указанном файле. Первая пара координат указывает верхний левый угол прямоугольника; Вторая пара задает ширину и высоту. Устройства с цифровым видео должны использовать команду MCI_CAPTURE для записи содержимого буфера кадра. (Устройства с наложением видео также должны использовать MCI_CAPTURE.) Этот флаг предназначен для совместимости с существующим набором команд MCI для наложения видео.

MCI_DGV_SAVE_ABORT

Останавливает выполняющиеся операции сохранения. Это должен быть единственный флаг.

MCI_DGV_SAVE_KEEPRESERVE

Неиспользуемое место на диске, оставшееся от исходной команды MCI_RESERVE , не освобождается.

Для цифровых видеоустройств параметр lpSave указывает на MCI_DGV_SAVE_PARMS структуру.

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

MCI_OVLY_RECT

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

Для устройств с наложением видео параметр lpSave указывает на структуру MCI_OVLY_SAVE_PARMS .

Требования

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

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

MCI

Команды MCI