Команда freeze

Статья
06/13/2023

Команда заморозки замораживает видеовход или вывод видео на 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. Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

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

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

Примеры

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

freeze vboard at 0 0 100 100

Требования

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

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

MCI
Командные строки MCI
capability;
Разморозить