Mci_record

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_RECORD, DWORD dwFlags, (DWORD) (LPMCI_RECORD_PARMS) lpRecord);

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

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

Аргументы

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

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

2. Данные флаги могут устанавливаться для всех устройств, обрабатывающих сообщение MCI_RECORD:

• MCI_FROM — в переменной dwFrom объекта структуры MCI_RECORD_PARMS, на который указывает аргумент lpRecord, содержится начальная позиция записи. Размерность величины, в которой задаётся начальная позиция, определяется флагом MCI_SET_TIME_FORMAT сообщения MCI_SET. Если флаг MCI_FROM не установлен, то запись начинается с текущей позиции.

• MCI_RECORD_INSERT — новая информация должна вставляться в существующие данные, не уничтожая их. Этот режим поддерживается не всеми устройствами, но, если он поддерживается, то используется по умолчанию.

• MCI_RECORD_OVERWRITE — записываемая информация стирает старые данные. Драйвер mciwave.drv при получении данного флага возвращает значение MCIERR_UNSUPPORTED_FUNCTION.

• MCI_TO — в переменной dwTo объекта структуры MCI_RECORD_PARMS, на который указывает аргумент lpRecord, содержится конечная позиция записи. Размерность величины, в которой задаётся начальная позиция, определяется флагом MCI_SET_TIME_FORMAT сообщения MCI_SET. Если флаг MCI_TO не установлен, то запись продолжается до конца имеющегося блока.

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

• MCI_DGV_RECORD_AUDIO_STREAM — в переменной dwAudioStream объекта структуры MCI_DGV_RECORD_PARMS, на который указывает аргумент lpRecord, содержится номер аудио потока. Если этот флаг не установлен, то аудио информация записывается в первый физический поток.

• MCI_DGV_RECORD_HOLD — при остановке записи на экране сохраняется последнее изображение. Для восстановления режима воспроизведения видеоинформации следует использовать команду MCI_MONITOR.

• MCI_DGV_RECORD_VIDEO_STREAM — в переменной dwVideoStream объекта структуры MCI_DGV_RECORD_PARMS, на который указывает аргумент lpRecord, содержится номер видео потока. Если этот флаг не установлен, то видеоинформация записывается в первый физический поток.

• MCI_DGV_RECT — в переменной rc объекта структуры MCI_DGV_RECORD_PARMS, на который указывает аргумент lpRecord, содержатся координаты прямоугольника. Этот прямоугольник определяет область изображения, поступающего из внешнего источника, которая будет сжиматься и сохраняться. По умолчанию используется прямоугольник, определяемый флагом MCI_DGV_PUT_VIDEO в команде MCI_PUT. Если указанный прямоугольник отличается от видео прямоугольника, то выводимая на экран информация отличается от записываемой.

0. Данные флаги могут использоваться устройствами типа vcr:

• MCI_VCR_RECORD_AT — в переменной dwAt объекта структуры MCI_VCR_RECORD_PARMS, на который указывает аргумент lpRecord, содержится время начала выполнения всей команды или, если устройство находится в режиме подготовки, время, когда будет достигнута позиция, указанная в сообщении MCI_CUE.

• MCI_VCR_RECORD_INITIALIZE — производит поиск на устройстве соответствующего носителя и начинает запись пустых видео и аудио кадров, если это возможно.

0. lpRecord — указатель на объект структуры MCI_RECORD_PARMS. (Устройства, имеющие расширенный набор команд, используют вместо этой структуры собственные структуры.)

Примечание

Команда MCI_RECORD начинает запись информации с текущей позиции или с одной указанной позиции до другой указанной позиции. Эту команду можно посылать видеомагнитофону и устройству вывода аудио информации в формате ИКМ.

Хотя устройства записи видео информации и устройству ввода аудио информации в формате MIDI распознают эту команду, драйверы MCIAVI и MCISEQ её не реализуют.

Эта команда может быть выполнена устройствами, для которых команда MCI_GETDEVCAPS в которой установлен флаг MCI_GETDEVCAPS_CAN_RECORD возвращает значение TRUE. Для драйвера MCIAVI вся информация, записанная после открытия файла, не запоминается в нём, если файл был закрыт без сохранения информации.

При работе с устройством вывода видео информации в переменной lpRecord передаётся указатель на объект структуры MCI_DGV_RECORD_PARMS, а при работе с видеомагнитофоном — указатель на объект структуры MCI_VCR_RECORD_PARMS.

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