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

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

Метод ActivateButton активирует выбранную в данный момент кнопку меню.

Синтаксис

HRESULT ActivateButton();

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

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

Код возврата	Описание
S_OK	Успешно.
VFW_E_DVD_INVALIDDOMAIN	DVD-навигатор находится в недопустимом домене.
VFW_E_DVD_OPERATION_INHIBITED	Элемент управления UOP запрещает DVD-навигатору переходить в приостановленное состояние.
VFW_E_DVD_NO_BUTTON	Кнопка не выбрана.

Комментарии

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

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

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

Требования

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

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

Приложения DVD

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

Интерфейс IDvdControl2

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