Mci_reserve

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_RESERVE, DWORD dwFlags, (DWORD) (LPMCI_DGV_RESERVE_PARMS) lpReserve);

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

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

Аргументы

0. wDeviceID — идентификатор устройства MCI, которому посылается данное командное сообщение.

1. dwFlags — Флаги сообщения MCI_NOTIFY, MCI_WAIT или для видеомагнитофона и устройства вывода видео информации MCI_TEST. Кроме того, для сообщения MCI_RECORD определены следующие флаги:

2. Данные флаги могут использоваться устройствами записи цифровой видеоинформации (устройства типа digitalvideo):

• MCI_DGV_RESERVE_IN — в переменной lpstrPath объекта структуры MCI_DGV_RESERVE_PARMS, на который указывает аргумент lpReserve, содержится указатель на буфер, содержащий местоположение временного файла. Буфер содержит только идентификатор диска и путь к файлу, используемому для хранения записанных данных, а имя файла определено в драйвере устройства. Этот временный файл уничтожается при закрытии данного экземпляра устройства, если до этого его содержимое не будет явным образом сохранено. Если этот флаг не установлен, то место для размещения временного файла выбирает драйвер устройства.

• MCI_DGV_RESERVE_SIZE — в переменной dwSize объекта структуры MCI_DGV_RESERVE_PARMS, на который указывает аргумент lpReserve, содержится приблизительный объём дискового пространства, которое следует выделить для записи информации. Размерность этой величины определяется текущим форматом времени. Размер дискового пространства определяется указанным временем, а также форматом файла и используемым алгоритмом сжатия аудио или видео информации. Если этот флаг не установлен, драйвер устройства может использовать значение, установленное по умолчанию.

0. lpReserve — указатель на объект структуры MCI_DGV_RESERVE_PARMS.

Примечание

Команда MCI_RESERVE выделяет непрерывную область дискового пространства драйверу устройства для записи в неё информации. Эту команду можно посылать устройству записи видеоинформации.

Если данные из этой области дискового пространства не сохраняются, то они теряются. Если до начала операции записи драйверу устройства не было выделено дисковое пространство, команда MCI_RECORD производит выделение этой области, используя параметры, установленные по умолчанию. Некоторые версии драйверов устройств не требуют обязательного резервирования дискового пространства. Явное выделение дискового пространства драйверу устройства позволяет приложению контролировать величину возможной задержки операции записи, а также размер и размещение выделяемого дискового пространства. Размер и размещение дискового пространства, уже выделенного данному экземпляру драйвера устройства, могут быть изменены повторной посылкой команды MCI_RESERVE. Любое выделенное, но неиспользованное дисковое пространство не освобождается до тех пор, пока не будут сохранена записанная в него информация или пока не будет закрыт использующий её экземпляр драйвера устройства.

Если запись видеоинформации отключена флагом MCI_OFF в команде MCI_SETVIDEO, в выделенную область дискового пространства не записывается видеоинформация. Если запись видеоинформации отключена флагом MCI_OFF в команде MCI_SETAUDIO, в выделенную область дискового пространства не записывается аудио информация. Если отключается запись как видео, так и аудио информации или если задаётся нулевой размер выделяемой области дискового пространства, всё зарезервированное до этого дисковое пространство освобождается.

Описание данного сообщения содержится в файле заголовка mmsystem.h.