команда MCI_PUT

Команда MCI_PUT задает прямоугольники источника, назначения и рамки. Устройства цифрового видео и наложения видео распознают эту команду.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PUT, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

Параметры

wDeviceID

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

Dwflags

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

lpDest

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

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

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

Комментарии

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

MCI_DGV_PUT_CLIENT

Прямоугольник, определенный для MCI_DGV_RECT, применяется к положению окна клиента. Указанный прямоугольник относится к родительскому окну окна отображения. MCI_DGV_PUT_WINDOW необходимо задать одновременно с этим флагом.

MCI_DGV_PUT_DESTINATION

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

MCI_DGV_PUT_FRAME

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

Прямоугольник указывается в координатах буфера кадров. Прямоугольник по умолчанию — это буфер полного кадра. Указание этого прямоугольника позволяет устройству масштабировать изображение по мере оцифровки данных. Устройства, которые не могут масштабировать образ, отклоняют эту команду с помощью MCIERR_UNSUPPORTED_FUNCTION. Вы можете использовать флаг MCI_GETDEVCAPS_CAN_STRETCH с командой MCI_GETDEVCAPS , чтобы определить, масштабируется ли изображение устройством. Если не удается масштабировать изображение, устройство возвращает значение FALSE .

MCI_DGV_PUT_SOURCE

Прямоугольник, определенный для MCI_DGV_RECT, задает исходный прямоугольник. Исходный прямоугольник указывает, какая часть буфера кадров должна масштабироваться для размещения в прямоугольнике назначения.

MCI_DGV_PUT_VIDEO

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

MCI_DGV_PUT_WINDOW

Прямоугольник, определенный для MCI_DGV_RECT, применяется к окну отображения. Этот прямоугольник находится относительно родительского окна окна отображения (обычно рабочего стола). Если окно не указано, по умолчанию используется исходный размер и положение окна.

MCI_DGV_RECT

Rc-член структуры, определяемой lpDest, содержит допустимый прямоугольник.

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

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

MCI_OVLY_PUT_DESTINATION

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

MCI_OVLY_PUT_FRAME

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

MCI_OVLY_PUT_SOURCE

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

MCI_OVLY_PUT_VIDEO

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

MCI_OVLY_RECT

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

Для устройств с наложением видео lpDest указывает на структуру MCI_OVLY_RECT_PARMS .

Требования

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

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

MCI

Команды MCI