Метод IDvdControl2::SelectVideoModePreference (strmif.h)
[Функция, связанная с этой страницей 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 .
Возвращаемое значение
Возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Успешно. |
|
Недопустимый аргумент. |
|
Недопустимый домен. |
|
Элемент управления UOP запрещает операцию. |
Комментарии
Этот метод изменяет пропорции окна видео по умолчанию, а также может указывать механизм преобразования пропорций по умолчанию.
Для анаморфного исходного видео 16 x 9, сформированного путем растяжения исходного видео 720 x 480 до пропорций 16 x 9.
Широкоэкранный Исходное видео 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 |
|
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |