IMFPMediaPlayer：：SetAspectRatioMode 方法 (mfplay.h)

重要 废弃。 此 API 可能会从 Windows 的未来版本中删除。 应用程序应使用 媒体会话 进行播放。

 

指定是否在播放期间保留视频的纵横比。

语法

HRESULT SetAspectRatioMode(
  [in] DWORD dwAspectRatioMode
);

参数

[in] dwAspectRatioMode

MFVideoAspectRatioMode 枚举中的一个或多个标志的按位 OR。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。
MF_E_INVALIDREQUEST	当前媒体项不包含视频。
MF_E_SHUTDOWN	调用了对象的 Shutdown 方法。

注解

如果当前未设置媒体项，或者当前媒体项不包含视频，则此方法失败。

若要在播放开始前设置纵横比模式，请在事件处理程序中为 MFP_EVENT_TYPE_MEDIAITEM_SET 事件调用此方法。 有关详细信息，请参阅 IMFPMediaPlayerCallback：：OnMediaPlayerEvent。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	mfplay.h

另请参阅

IMFPMediaPlayer

使用 MFPlay 播放音频/视频