команда MCI_RECORD

  • Статья

Команда MCI_RECORD начинает запись из текущей позиции или из одного указанного расположения в другое указанное расположение. Устройства VCR и waveform-audio распознают эту команду. Хотя цифровые видеоустройства и секвенсоры MIDI также распознают эту команду, драйверы MCIAVI и MCISEQ не реализуют ее.

Чтобы отправить эту команду, вызовите функцию mciSendCommand со следующими параметрами.

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

Параметры

wDeviceID

Идентификатор устройства MCI, которое будет получать сообщение команды.

Dwflags

MCI_NOTIFY, MCI_WAIT или для устройств с цифровым видео и VCR MCI_TEST. Сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

lpRecord

Указатель на структуру MCI_RECORD_PARMS . (Устройства с расширенными наборами команд могут заменить эту структуру структурой для конкретного устройства.)

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

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

Комментарии

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

Следующие дополнительные флаги применяются ко всем устройствам, поддерживающим MCI_RECORD:

MCI_FROM

Начальное расположение включается в элемент dwFrom структуры, определяемой lpRecord. Единицы измерения, назначенные значениям позиции, указываются с помощью флага MCI_SET_TIME_FORMAT команды MCI_SET . Если MCI_FROM не указан, по умолчанию в качестве начального расположения используется текущая позиция.

MCI_RECORD_INSERT

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

MCI_RECORD_OVERWRITE

Данные должны перезаписывать существующие данные. The MCIWAVE. Устройство DRV возвращает MCIERR_UNSUPPORTED_FUNCTION в ответ на этот флаг.

MCI_TO

Конечное расположение включается в элемент dwTo структуры, определяемой lpRecord. Единицы измерения, назначенные значениям позиции, указываются с помощью флага MCI_SET_TIME_FORMAT команды MCI_SET . Если MCI_TO не указан, конечным расположением по умолчанию является конец содержимого.

Следующие дополнительные флаги используются с типом устройства digitalvideo :

MCI_DGV_RECORD_AUDIO_STREAM

Номер аудиопотока включается в элемент dwAudioStream структуры, определяемой lpRecord. Если этот флаг не указан, звуковые данные записываются в первый физический поток.

MCI_DGV_RECORD_HOLD

Когда запись останавливается, экран будет содержать последнее изображение и не будет возобновлять показ видео до тех пор, пока не будет выполнена MCI_MONITOR команда.

MCI_DGV_RECORD_VIDEO_STREAM

Номер видеопотока включается в элемент dwVideoStream структуры, определяемой lpRecord. Если этот флаг не указан, видеоданные записываются в первый физический поток.

MCI_DGV_RECT

Прямоугольник указывается в rc-элементе структуры, определяемой lpRecord. Прямоугольник задает область внешних входных данных, используемых в качестве источника для сжатых и сохраненных пикселей. По умолчанию в этом прямоугольнике используется прямоугольник, заданный (или заданный по умолчанию) флагом MCI_DGV_PUT_VIDEO для команды MCI_PUT . Если он задан иначе, чем прямоугольник видео, то, что отображается, не то, что записывается

Для цифровых видеоустройств lpRecord указывает на структуру MCI_DGV_RECORD_PARMS .

Следующие дополнительные флаги используются с типом устройства vcr :

MCI_VCR_RECORD_AT

Элемент dwAt структуры, определяемой lpRecord , содержит время начала всей команды или, если устройство определяется, когда устройство достигает позиции from, заданной командой подсказки.

MCI_VCR_RECORD_INITIALIZE

Найдите устройство до начала мультимедиа, начните запись пустого видео и звука и запишите код времени, если это возможно.

Для устройств VCR lpRecord указывает на структуру MCI_VCR_RECORD_PARMS .

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Mmsystem.h (включая Windows.h)

См. также раздел

MCI

Команды MCI