команда MCI_SAVE

  • Статья

Команда MCI_SAVE сохраняет текущий файл. Устройства, изменяющие файлы, не должны уничтожать исходную копию, пока не получат сообщение о сохранении. Эта команда распознает устройства с наложением видео и звуковой формой. Хотя цифровые видеоустройства и секвенсоры 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 . (Устройства с дополнительными параметрами могут заменить эту структуру структурой для конкретного устройства.)

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

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

Комментарии

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

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

MCI_SAVE_FILE

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

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

MCI_DGV_RECT

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

MCI_DGV_SAVE_ABORT

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

MCI_DGV_SAVE_KEEPRESERVE

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

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

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

MCI_OVLY_RECT

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

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

Требования

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

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

MCI

Команды MCI