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

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

  • Статья

[Функция, связанная с этой страницей 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