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

Статья
07/28/2023

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

Метод SelectDefaultAudioLanguage задает язык звука по умолчанию.

Синтаксис

HRESULT SelectDefaultAudioLanguage(
  [in] LCID               Language,
  [in] DVD_AUDIO_LANG_EXT audioExtension
);

Параметры

[in] Language

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

[in] audioExtension

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

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

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

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

Этот метод выбирает язык по умолчанию и расширения языка для использования при воспроизведении диска. Например, если для английского языка указано 0x409, а audioExtension — DVD_AUD_EXT_NotSpecified, DVD-навигатор будет искать основной аудиопоток на английском языке. Если audioExtension указано как DVD_AUD_EXT_VisuallyImpaired, DVD-навигатор сначала ищет специальный аудиопоток на английском языке для людей со слабым зрением. Если поток по умолчанию не найден на диске, DVD-навигатор выберет ближайшее совпадение.

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

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

Требования

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

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

Dvd-приложения

Коды ошибок и успешности

Интерфейс IDvdControl2

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