Команда where

Статья
06/13/2023

Команда where извлекает прямоугольник, указывающий исходную или целевую область. Этот прямоугольник был указан с помощью команды put . Устройства цифрового видео и наложения видео распознают эту команду.

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

_stprintf_s(
  lpszCommand, 
  TEXT("where %s %s %s"), 
  lpszDeviceID, 
  lpszRequestRect, 
  lpszFlags
);

Параметры

lpszDeviceID

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

lpszRequestRect

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

Значение	Значение	Значение
digitalvideo	destinationdestination maxframeframe maxsource	source maxvideovideo maxwindowwindow max
overlay	целевой кадр	sourcevideo

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

Значение	Значение
ресурс destination	Извлекает смещение и экстент назначения. Для устройств с наложением видео прямоугольник назначения определяет область клиентской области окна отображения, которая отображает данные изображения из буфера кадров.
destination max	Извлекает текущий размер клиентского прямоугольника.
frame	Извлекает смещение и экстент прямоугольника буфера кадров. Прямоугольник буфера кадров определяет область буфера кадров, который получает входящие видеоданные. Изображения из "видео" прямоугольника масштабируются в этой области.
максимальное число кадров	Возвращает максимальный размер буфера кадров.
source	Извлекает исходное смещение и экстент. Для устройств с наложением видео исходный прямоугольник определяет область буфера кадров, отображаемого в окне назначения. Устройство использует этот прямоугольник для обрезки изображения перед его растягиванием в соответствии с целевым прямоугольником на дисплее.
source max	Извлекает максимальный размер буфера кадров.
видео	Извлекает смещение и экстент прямоугольника видео. Прямоугольник видео определяет область входящих видеоданных, передаваемых в буфер кадров.
video max	Возвращает максимальный размер входных данных.
window	Извлекает текущий размер и положение рамки окна отображения.
window max	Извлекает размер всего дисплея.

lpszFlags

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

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

Возвращает прямоугольник в параметре lpszReturnString функции mciSendString . Прямоугольник описывает область, указанную в параметре lpszRequestRect этой команды. Прямоугольник указан как X1 Y1 X2 Y2. Координаты X1 Y1 указывают левый верхний угол прямоугольника, а координаты X2 Y2 — ширину и высоту.

Примеры

Следующая команда возвращает прямоугольник отображения устройства movie.

where movie destination

Требования

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

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

MCI
Командные строки MCI
Положить