Команда put
Команда put определяет область исходного изображения и окна назначения, используемые для отображения. Устройства цифрового видео и наложения видео распознают эту команду.
Чтобы отправить эту команду, вызовите функцию mciSendString с заданным параметром lpszCommand , как показано ниже.
_stprintf_s(
lpszCommand,
TEXT("put %s %s %s"),
lpszDeviceID,
lpszRegions,
lpszFlags
);
-
lpszDeviceID
-
Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.
-
lpszRegions
-
Флаг для определения области. В следующей таблице перечислены типы устройств, которые распознают команду put, и флаги, используемые каждым типом.
Значение Значение Значение digitalvideo назначение в кадре прямоугольникав источнике источника прямоугольникав прямоугольнике видео в окне окна прямоугольникав клиенте клиентского окна прямоугольникав прямоугольнике overlay назначение назначения в прямоугольнойрамке кадра в прямоугольнике источник источника видео в прямоугольникевидео на прямоугольнике В следующей таблице перечислены флаги, которые можно указать в параметре lpszRegions , и их значения.
Значение Значение ресурс destination Выбирает всю клиентную область окна назначения для отображения данных. назначение в прямоугольнике Выбирает часть клиентской области окна назначения, которая используется для отображения изображения. Если указана область окна отображения и устройство поддерживает растяжение, исходное изображение растягивается до целевого смещения и экстента. frame Выбирает весь буфер кадров для получения входящих видеоизобращений. рамка в прямоугольнике Выбирает часть буфера кадров для получения входящих видеоизов. source Выбирает все изображение для отображения в окне назначения. источник в прямоугольнике Выбирает часть изображения для отображения в окне назначения. Если указана область исходного образа и устройство поддерживает растяжение, исходный образ растягивается до целевого смещения и экстента. видео Выбирает все входящее видеоизобращение для записи в буфер кадров. видео на прямоугольнике Выбирает часть входящего видеоизобращения для записи в буфер кадров. window Восстанавливает начальный размер окна на дисплее. Эта команда также отображает окно . окно в прямоугольнике Изменяет размер и расположение окна отображения. Указанный прямоугольник относится к родительскому окну окна отображения (обычно рабочего стола), если для открытой команды использовался флаг "стиль дочернего элемента". Чтобы изменить расположение окна, не изменяя его высоту или ширину, укажите ноль для высоты и ширины. клиент window Восстанавливает клиентную область окна. клиент окна в прямоугольнике Изменяет размер и расположение клиентской области окна. Указанный прямоугольник относится к родительскому окну клиентского окна. Чтобы изменить расположение окна, не изменяя его высоту или ширину, укажите ноль для высоты и ширины. Если флаг включает прямоугольник, координаты прямоугольника соответствуют источнику окна или источнику изображения соответственно и указываются как X1 Y1 X2 Y2 Y2. Координаты X1Y1 указывают левый верхний угол, а координаты X2Y2 — ширину и высоту прямоугольника.
-
lpszFlags
-
Может иметь значение "wait", "notify" или и то, и другое. Для цифровых видеоустройств также можно указать "test". Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.
Возвращает ноль при успешном выполнении или ошибке в противном случае.
Команда put определяет один или несколько из следующих прямоугольников при работе с устройствами наложения видео:
- Прямоугольник видео определяет область входящего видеоизущего изображения для захвата.
- Прямоугольник кадра определяет область буфера кадров, который получает входящее видео.
- Исходный прямоугольник определяет, какая область буфера кадров копируется в целевой прямоугольник.
- Прямоугольник назначения определяет область клиентской области окна отображения, которая получает видеоизу.
Прямоугольник видео связан с прямоугольником кадра так же, как исходный прямоугольник связан с прямоугольником назначения. Растяжение может происходить от прямоугольника видео до прямоугольника кадра и от исходного прямоугольника до прямоугольника назначения. Не все устройства поддерживают растяжение, и растяжение должно быть включено (с помощью команды set ).
Следующая команда определяет три области для видео, кадра и источника.
put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200
Регионы в этом примере определяются следующим образом:
- Область входящих видеоданных размером 200 х 200 пикселей, начиная с 120 пикселей от верхнего левого угла, будет записана в буфер кадров.
- Видеоданные будут помещены в область размером 200 на 200 пикселей в левом верхнем углу буфера кадров.
- Передача выполняется из области размером 200 на 200 пикселей в левом верхнем углу буфера кадров в целевое окно.
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |