IMFPMediaPlayer：：SetVideoSourceRect 方法 (mfplay.h)

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

 

设置视频源矩形。

MFPlay 将视频剪辑到此矩形，并拉伸矩形以填充视频窗口。

语法

HRESULT SetVideoSourceRect(
  [in] const MFVideoNormalizedRect *pnrcSource
);

参数

[in] pnrcSource

指向指定源矩形的 MFVideoNormalizedRect 结构的指针。 此矩形定义显示视频的哪个部分。 它在规范化坐标中指定，定义如下：

• 视频图像的左上角 (为 0,0) 。
• 视频图像的右下角 (1、1) 。

若要显示整个图像，请将源矩形设置为 {0， 0， 1， 1}。 这是默认值。

返回值

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

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

注解

MFPlay 拉伸源矩形以填充整个视频窗口。 默认情况下，MFPlay 会保留源的正确纵横比，如果需要，使用信箱。 信箱颜色由 IMFPMediaPlayer：：SetBorderColor 方法控制。

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

若要在播放开始前设置视频位置，请在 MFP_EVENT_TYPE_MEDIAITEM_SET 事件的事件处理程序中调用此方法。 有关详细信息，请参阅 IMFPMediaPlayerCallback：：OnMediaPlayerEvent。

要求

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

另请参阅

IMFPMediaPlayer

使用 MFPlay 播放音频/视频