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