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

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

  • Статья

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

Метод ShowMenu отображает указанное меню, если доступно.

Синтаксис

HRESULT ShowMenu(
  [in]  DVD_MENU_ID MenuID,
  [in]  DWORD       dwFlags,
  [out] IDvdCmd     **ppCmd
);

Параметры

[in] MenuID

Значение перечисления DVD_MENU_ID , указывающее отображаемое меню.

[in] dwFlags

Побитовое ИЛИ одного или нескольких флагов из перечисления DVD_CMD_FLAGS , указывающее способ синхронизации команды.

[out] ppCmd

Получает указатель на объект IDvdCmd, который можно использовать для синхронизации команд DVD. Вызывающий объект должен освободить интерфейс . Этот параметр может принимать значение NULL. Дополнительные сведения см. в разделе Синхронизация команд DVD.

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

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

Код возврата Описание
S_OK
 Успешно.
E_INVALIDARG
 Недопустимый параметр MenuID .
VFW_E_DVD_INVALIDDOMAIN
 Недопустимый домен.
VFW_E_DVD_MENU_DOES_NOT_EXIST
 Указанное меню не существует.
VFW_E_DVD_OPERATION_INHIBITED
 Элемент управления UOP запрещает операцию.

Комментарии

Меню диспетчера видео (VMGM) должно быть доступно из доменов Title или Video Title Set. Меню "Набор заголовков видео" (VTSM) может быть доступно только через VMGM. Все подменю в каждой виртуальной машины (для глав, углов, аудио- и вложенных потоков) доступны только через этот VTSM.

Этот метод демонстрируется в приложении ПРИЛОЖЕНИЯ DVDSample в CDvdCore::RootMenu и CDvdCore::TitleMenu.

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

Имя команды Приложения J Допустимые домены
Menu_Call Все.

Требования

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

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

Приложения DVD

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

Интерфейс IDvdControl2

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