команда 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 [только классические приложения] |
| Заголовок |
|