команда reserve
Команда резервирования выделяет непрерывное дисковое пространство для рабочей области экземпляра устройства. Цифровые видеоустройства распознают эту команду.
Чтобы отправить эту команду, вызовите функцию mciSendString с параметром lpszCommand , как показано ниже.
_stprintf_s(
lpszCommand,
TEXT("reserve %s %s %s"),
lpszDeviceID,
lpszReserve,
lpszFlags
);
Параметры
-
lpszDeviceID
-
Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.
-
lpszReserve
-
Один или несколько из следующих флагов.
Значение Значение в пути Указывает путь к диску и каталогу (но не имя) временного файла, используемого для хранения записанных данных. Имя этого файла задается устройством. Временный файл удаляется при закрытии устройства. Если этот флаг не указан, устройство указывает расположение дискового пространства. длительность размера Указывает приблизительный объем дискового пространства для резервирования в рабочей области. Значение длительности указывается в формате текущего времени. Оценка требуемого места на диске устройства основывается на следующих параметрах: запрошенное время, формат файла, алгоритм сжатия видео и аудио, а также фактические значения качества сжатия. Если setvideo "record" имеет значение "off", пространство зарезервировано только для звука. Если setaudio "record" имеет значение "off", пространство зарезервировано только для видео. Если оба параметра имеют значение "off" или если длительность равна нулю, то место не резервируется, а любое существующее зарезервированное пространство освобождается. Если этот флаг не указан, устройство будет использовать определенное устройством значение по умолчанию. -
lpszFlags
-
Может иметь значение "wait", "notify", "test" или их сочетание. Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.
Возвращаемое значение
Возвращает ноль в случае успешного выполнения или ошибку в противном случае.
Комментарии
При необходимости последующие команды записи или сохранения используют пространство, зарезервированное этой командой. Если рабочая область содержит несохраненные данные, данные теряются. Некоторые устройства не требуют резервирования и игнорируют его. Если место на диске не зарезервировано до записи, команда record выполняет неявное резервирование с флагами по умолчанию для конкретного устройства. Используйте явную команду резервирования, чтобы лучше контролировать время задержки для выделения диска, управлять объемом выделенного места и местом, где выделяется дисковое пространство. Приложение может изменить объем и расположение ранее зарезервированного места на диске с помощью последующих команд резервирования. Все выделенное и неиспользуемое дисковое пространство не освобождается до тех пор, пока не будут сохранены все записанные данные или пока экземпляр устройства не будет закрыт.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |