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

另请参阅

错误和成功代码

IOverlay 接口