iOverlay：：Advise 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 Advise 为 dwInterests 参数指定的覆盖事件设置建议链接。
语法
HRESULT Advise(
[in] IOverlayNotify *pOverlayNotify,
[in] DWORD dwInterests
);
参数
[in] pOverlayNotify
指向通知接口的指针。
[in] dwInterests
感兴趣的回调，可以是以下事件的任何子集。
| 事件 | 说明 |
|---|---|
| ADVISE_NONE | 无更改。 |
| ADVISE_CLIPPING | 剪辑区域的更改 (与窗口) 同步。 |
| ADVISE_PALETTE | 在调色板中更改。 |
| ADVISE_COLORKEY | 色度键值的更改。 |
| ADVISE_POSITION | 视频窗口的位置更改 (与窗口) 不同步。 |
| ADVISE_DISPLAY_CHANGE | 在 WM_DISPLAYCHANGE 上调用。 当显示分辨率发生更改时，WM_DISPLAYCHANGE消息将发送到所有窗口。 |
| ADVISE_ALL2 | 以上都是。 |
返回值
如果成功，则返回S_OK。 如果方法失败，它将返回 HRESULT 错误代码。
注解
此方法为 IOverlayNotify 接口设置一个建议链接以接收通知。 如果发生其中一个事件，传入的 pOverlayNotify 参数中的相应入口点 (调用 IOverlayNotify：：OnClipChange、 IOverlayNotify：：OnColorKeyChange、 IOverlayNotify：：OnPaletteChange 或 IOverlayNotify：：OnPositionChange) 。
在任何给定 的 IOverlay 接口上只能设置一个建议链接。 尝试对第二次和后续调用设置另一个通知接口会返回VFW_E_ADVISE_ALREADY_SET。 可以使用 IOverlay：：Unadvise 取消建议链接。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |