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

Статья
07/28/2023

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

Метод SelectDefaultSubpictureLanguage задает язык по умолчанию для текста подпиктуры.

Синтаксис

HRESULT SelectDefaultSubpictureLanguage(
  [in] LCID                    Language,
  [in] DVD_SUBPICTURE_LANG_EXT subpictureExtension
);

Параметры

[in] Language

Идентификатор языкового стандарта, указывающий язык по умолчанию.

[in] subpictureExtension

DVD_SUBPICTURE_LANG_EXT перечисление, указывающее расширение подпиктуры по умолчанию.

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

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

Код возврата	Описание
S_OK	Успешно.
E_INVALIDARG	Недопустимый язык .
VFW_E_DVD_INVALIDDOMAIN	Фильтр DVD-навигатора не находится в допустимом домене.

Этот метод выбирает язык и формат по умолчанию для вложенных диаграмм и меню при воспроизведении диска. Например, если язык указан как 0x409 для английского языка США, а subpictureExtension указан как DVD_SP_EXT_Caption_Big, DVD-навигатор пытается отобразить текст на английском языке США в формате "большой подпись" в подпиктурах. Если язык или расширение языка по умолчанию не найдено на диске, DVD-навигатор выбирает ближайшее совпадение.

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

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

Требования

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

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

Приложения DVD

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

Интерфейс IDvdControl2

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