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

Статья
03/02/2024

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

Метод SelectVideoModePreference задает для воспроизведения указанный режим видео (широкий экран, почтовое поле или сдвига).

Синтаксис

HRESULT SelectVideoModePreference(
  [in] ULONG ulPreferredDisplayMode
);

Параметры

[in] ulPreferredDisplayMode

Значение, указывающее новый режим отображения содержимого DVD. Член перечисления DVD_PREFERRED_DISPLAY_MODE .

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

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

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

Широкоэкранный Исходное видео 16 x 9 должно быть помещено и растянуто в самую большую область 16 x 9 в окне вывода клиента. Основные моменты находятся относительно внутренней части области 16 x 9. Черные полосы следует добавлять в верхнюю или нижнюю части или по бокам, чтобы сохранить область 16 x 9.

Сканирование сдвига Показанное видео вычисляется путем взятия подокна 4 x 3 из растянутого видео 16 x 9 (горизонтальное смещение предоставляется в смещении окна видео MPEG-2). Подокно 4 x 3 помещается в самую большую область 4 x 3 окна клиента вывода. Координаты выделения находятся относительно окна вывода 4 x 3 (и не имеют связи с исходным видео 16 x 9). Черные полосы следует добавлять в верхнюю или нижнюю часть или по бокам, чтобы сохранить область 4 x 3.

Почтовый ящик Область отображения 4 x 3 формируется путем принятия самой большой области 4 x 3 в окне вывода клиента. Черные полосы следует добавлять в верхнюю или нижнюю часть или по бокам, чтобы сохранить область 4 x 3. Исходное видео 16 x 9 помещается в самое большое подокно 16 x 9 внутри 4 x 3 подокна. Черные полосы следует добавить в верхнюю и нижнюю части подокна, чтобы сохранить область 16 x 9. Координаты выделения находятся относительно подокна 4 x 3 (и не имеют отношения к исходному видео 16 x 9). Технически возможно, что диск может указать выделение, которое находится за пределами области 16 x 9 (но все еще в окне 4 x 3).

Для видео 4 x 3 видео помещается в самую большую область вывода 4 x 3 окна клиента вывода. Черные полосы следует добавлять в верхнюю или нижнюю часть или по бокам, чтобы сохранить область 4 x 3.

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

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

Требования

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

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

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

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

Интерфейс IDvdControl2

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