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