IDDrawExclModeVideoCallback::OnUpdateOverlay 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
当视频的覆盖图面即将变为可见、不可见、更改大小或更改位置时,方法 OnUpdateOverlay
会通知应用程序,以便应用程序可以相应地重新绘制其窗口。
语法
HRESULT OnUpdateOverlay(
[in] BOOL bBefore,
[in] DWORD dwFlags,
[in] BOOL bOldVisible,
[in] const RECT *prcOldSrc,
[in] const RECT *prcOldDest,
[in] BOOL bNewVisible,
[in] const RECT *prcNewSrc,
[in] const RECT *prcNewDest
);
参数
[in] bBefore
指定是在覆盖相关更改之前还是之后进行调用的布尔值。 TRUE 指定 before,FALSE 指定 after。
[in] dwFlags
AM_OVERLAY_NOTIFY_FLAGS枚举中的值,用于指定要更改的内容或更改的内容。
[in] bOldVisible
指定旧窗口是否可见的布尔值。 TRUE 表示旧窗口可见。
[in] prcOldSrc
指向表示 DirectDraw 图面的旧源位置的矩形的指针。
[in] prcOldDest
指向矩形的指针,表示矩形在覆盖图面中的旧目标位置。
[in] bNewVisible
指定新窗口是否可见的布尔值。 TRUE 表示新窗口可见。
[in] prcNewSrc
指向表示 DirectDraw 图面的新源位置的矩形的指针。
[in] prcNewDest
指向矩形的指针,表示矩形在覆盖图面中的新目标位置。
返回值
返回 HRESULT 值。 可能的值包括以下值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
参数无效。 |
注解
应用程序应在覆盖相关更改发生之前调用此方法一次,在完成更改后调用一次。 在更改前的调用中,覆盖更改在应用程序完成执行此方法之前不会发生。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | strmif.h (包括 Dshow.h) |
Library | Strmiids.lib |