IBasicVideo::SetDestinationPosition 方法 (control.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 SetDestinationPosition
设置目标矩形。
语法
HRESULT SetDestinationPosition(
[in] long Left,
[in] long Top,
[in] long Width,
[in] long Height
);
参数
[in] Left
指定 x 坐标(以像素为单位)。
[in] Top
指定 y 坐标(以像素为单位)。
[in] Width
指定宽度(以像素为单位)。
[in] Height
指定高度(以像素为单位)。
返回值
返回 HRESULT 值。 可能的值包括以下值。
返回代码 | 说明 |
---|---|
|
无效的参数。 宽度 和 高度 必须大于零。 |
|
方法成功。 |
|
视频呈现器未连接。 |
注解
此方法的效果与单独调用 IBasicVideo::p ut_DestinationLeft、 IBasicVideo::p ut_DestinationTop、 IBasicVideo::p ut_DestinationWidth 和 IBasicVideo::p ut_DestinationHeight 方法的效果相同。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | control.h (包括 Dshow.h) |
Library | Strmiids.lib |