Метод IDvdControl2::ActivateAtPosition (strmif.h)

Статья
07/28/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод ActivateAtPosition активирует кнопку меню под положением указателя мыши.

Синтаксис

HRESULT ActivateAtPosition(
  [in] POINT point
);

Параметры

[in] point

Наведите указатель на область окна клиента в пиксельных координатах экрана.

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

Возвращает одно из следующих значений.

Код возврата	Описание
S_OK	Щелчок произошел в выделенном прямоугольнике кнопки, и кнопка была успешно активирована.
E_INVALIDARG	Точка находится за пределами допустимой области видео.
E_UNEXPECTED	Кнопка присутствует, но не работает.
VFW_E_DVD_INVALIDDOMAIN	DVD-навигатор не находится в домене меню.
VFW_E_DVD_NO_BUTTON	Под положением указателя мыши нет кнопки меню.
VFW_E_DVD_OPERATION_INHIBITED	Эта операция блокируется элементом управления пользовательской операцией (UOP).

Координаты указателя мыши относятся к левому верхнему краю клиентской области, которая не обязательно является областью отображения видео, если видео имеет формат letterbox.

Используйте этот метод, если пользователь перемещается по меню путем наведения указателя мыши непосредственно на кнопки меню. Если пользователь использует относительные кнопки для навигации по меню, используйте ActivateButton , а не ActivateAtPosition.

В следующей таблице приведено имя команды Приложения J, которой соответствует это имя метода, и домены, в которых этот метод является допустимым.

Имя команды Приложения J	Допустимые домены
None	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)
Библиотека	Strmiids.lib

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

Приложения DVD

Коды ошибок и успешного выполнения

Интерфейс IDvdControl2

Работа с меню DVD

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