Поделиться через

Команда freeze

  • Статья

Команда заморозки замораживает видеовход или вывод видео на VCR или отключает получение видео в буфер кадров. Устройства с цифровым видео, видео наложением и VCR распознают эту команду.

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

_stprintf_s(
  lpszCommand, 
  TEXT("freeze %s %s %s"), 
  lpszDeviceID, 
  lpszFreezeFlags, 
  lpszFlags
);

Параметры

lpszDeviceID

Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.

lpszFreezeFlags

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

Значение Значение Значение
digitalvideo в прямоугольнике За пределами
overlay в прямоугольнике
Видео
  • поле
  • frame
  • input
  • output

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

Значение Значение
в прямоугольнике Указывает регион, который будет заморожен. Для устройств с наложением видео в этом регионе будет отключено получение видео. Для цифровых видеоустройств в пикселях в прямоугольнике будет включен бит маски блокировки (если не указан флаг "вне"). Прямоугольник находится относительно источника буфера видео и указан как X1 Y1 X2 Y2 Y2. Координаты X1 Y1 указывают левый верхний угол прямоугольника, а координаты X2 Y2 — ширину и высоту.
поле Замораживает первое поле. Поле принимается по умолчанию (если ни кадр, ни поле не указаны).
frame Замораживает весь кадр, отображая оба поля.
input Замораживает текущий кадр входного изображения, будь то приостановлено или запущено.
output Замораживает текущий кадр выходных данных из VCR. Если VCR воспроизводит при заморозке, текущий кадр зависает, а VCR приостанавливается. Если при выполнении этой команды VCR приостанавливается, текущий кадр зависает. Замороженный образ остается на устройстве вывода до тех пор, пока не будет выдана команда разблокировать . Если ни "input", ни "output" не указаны, предполагается "вывод".
За пределами Указывает, что область за пределами региона, указанного с помощью флага "at", заморожена.

lpszFlags

Может иметь значение "wait", "notify" или и то, и другое. Для устройств с цифровым видео и VCR также можно указать test. Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

Комментарии

При использовании с устройствами VCR эта команда предназначена для карт захвата кадров.

Чтобы указать нерегулярные регионы приобретения с флагом "at", используйте ряд команд заморозки и разморозки . Некоторые устройства с наложением видео ограничивают сложность региона приобретения.

Эта команда поддерживается только в том случае, если вызов команды capability с флагом "может заморозить" возвращает значение TRUE.

Примеры

Следующая команда отключает получение видео в квадрате размером 100 пикселей в левом верхнем углу буфера видео.

freeze vboard at 0 0 100 100

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]

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

MCI

Командные строки MCI

capability;

Разморозить