IDvdControl2：：SelectVideoModePreference 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 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 区域。
平移扫描 通过从拉伸的 16 x 9 视频中获取 4 x 3 子窗口， (在 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 视频放置在 4 x 3 子窗口内最大的 16 x 9 子窗口中。 应将黑条添加到子窗口的顶部和底部，以保持 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 |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |