команда MCI_PASTE

  • Статья

Команда MCI_PASTE вставляет данные из буфера обмена в файл. Цифровые видеоустройства распознают эту команду.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PASTE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_PASTE_PARMS) lpPaste
);

Параметры

wDeviceID

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

Dwflags

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

lpPaste

Указатель на MCI_ DGV_ PASTE_ структуру PARMS .

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

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

Комментарии

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

MCI_DGV_PASTE_AT

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

MCI_DGV_PASTE_AUDIO_STREAM

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

MCI_DGV_PASTE_INSERT

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

MCI_DGV_PASTE_OVERWRITE

Данные буфера обмена должны заменить данные, уже существующие в рабочей области. Замененные данные рабочей области следует за точкой вставки.

MCI_DGV_PASTE_VIDEO_STREAM

Номер видеопотока включается в элемент dwVideoStream структуры, определяемой lpPaste. Если в буфере обмена существует только один видеопоток, видеоданные вставляется в назначенный поток. Если в буфере обмена существует несколько видеопотоков, поток указывает начальный номер последовательностей потоков. Если вы используете этот флаг и хотите вставить звук, необходимо также использовать флаг MCI_DGV_PASTE_AUDIO_STREAM. (Если ни параметр не указан, то все аудио- и видеопотоки вставляется, начиная с первого аудио- и видеопотока. Каждый вставленный поток сохраняет свой исходный номер потока.)

MCI_TO

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

Требования

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

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

MCI

Команды MCI