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