команда MCI_WHERE

  • Статья

Команда MCI_WHERE получает прямоугольник обрезки для видеоустройства. Устройства цифрового видео и наложения видео распознают эту команду. Верхние и левые элементы возвращаемого элемента RECT содержат источник прямоугольника обрезки, а правые и нижние элементы — ширину и высоту прямоугольника обрезки. (Это не стандартное использование правых и нижних элементов.)

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WHERE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpQuery
);

Параметры

wDeviceID

Идентификатор устройства MCI, которое будет получать сообщение команды.

Dwflags

MCI_NOTIFY, MCI_WAIT или для цифровых видеоустройств MCI_TEST. Сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

lpQuery

Указатель на структуру MCI_GENERIC_PARMS . (Устройства с расширенными наборами команд могут заменить эту структуру структурой для конкретного устройства.)

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

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

Комментарии

Следующие дополнительные флаги используются с типом устройства digitalvideo :

MCI_DGV_WHERE_DESTINATION

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

MCI_DGV_WHERE_FRAME

Получает описание прямоугольной области буфера кадров, в которую масштабируются изображения из прямоугольника видео. Координаты прямоугольника помещаются в rc-член структуры, определяемой lpQuery.

MCI_DGV_WHERE_MAX

При использовании с MCI_DGV_WHERE_DESTINATION или MCI_DGV_WHERE_SOURCE возвращаемый прямоугольник указывает максимальную ширину и высоту указанной области. При использовании с MCI_DGV_WHERE_WINDOW возвращаемый прямоугольник указывает размер всего дисплея.

MCI_DGV_WHERE_SOURCE

Получает описание прямоугольной области (обрезанной из буфера кадров), растянутой в соответствии с прямоугольником назначения на дисплее.

MCI_DGV_WHERE_VIDEO

Получает описание прямоугольной области, обрезанной из источника презентации для заполнения прямоугольника кадра в буфере кадров. Координаты прямоугольника помещаются в rc-член структуры, определяемой lpQuery.

MCI_DGV_WHERE_WINDOW

Получает описание рамки окна отображения.

Для цифровых видеоустройств параметр lpQuery указывает на структуру MCI_DGV_WHERE_PARMS . Структура MCI_DGV_WHERE_PARMS идентична структуре MCI_DGV_RECT_PARMS .

Следующие дополнительные флаги используются с типом устройства наложения :

MCI_OVLY_WHERE_DESTINATION

Получает прямоугольник отображения назначения. Координаты прямоугольника помещаются в rc-член структуры, определяемой lpQuery.

MCI_OVLY_WHERE_FRAME

Получает прямоугольник рамки наложения. Координаты прямоугольника помещаются в rc-член структуры, определяемой lpQuery.

MCI_OVLY_WHERE_SOURCE

Получает исходный прямоугольник. Координаты прямоугольника помещаются в rc-член структуры, определяемой lpQuery.

MCI_OVLY_WHERE_VIDEO

Получает прямоугольник видео. Координаты прямоугольника помещаются в rc-член структуры, определяемой lpQuery.

Для устройств с наложением видео параметр lpQuery указывает на структуру MCI_OVLY_RECT_PARMS .

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Mmsystem.h (включая Windows.h)

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

MCI

Команды MCI