команда 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 [только классические приложения] |
| Заголовок |
|