IVMRSurfaceAllocatorNotify 接口 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

IVMRSurfaceAllocatorNotify 接口由 视频混合呈现器筛选器 7 (VMR-7) 实现。 应用程序使用此接口来设置自定义分配器-表示器,分配器-表示器使用此接口通知 VMR-7 影响 DirectDraw 图面的系统环境更改。

为了使应用程序获取此接口,VMR 必须处于无呈现模式。

对于 VMR-9,请使用 IVMRSurfaceAllocatorNotify9 接口。

继承

IVMRSurfaceAllocatorNotify 接口继承自 IUnknown 接口。 IVMRSurfaceAllocatorNotify 也具有以下类型的成员:

方法

IVMRSurfaceAllocatorNotify 接口具有这些方法。

 
IVMRSurfaceAllocatorNotify::AdviseSurfaceAllocator

应用程序调用 AdviseSurfaceAllocator 方法,以指示 VMR 使用自定义分配器-表示器。
IVMRSurfaceAllocatorNotify::ChangeDDrawDevice

ChangeDDrawDevice 方法通知 VMR DirectDraw 播放设备已更改。 例如,在多监视器系统上,用户已将视频矩形从一个监视器移动到另一个监视器。
IVMRSurfaceAllocatorNotify::NotifyEvent

分配器演示者调用 NotifyEvent 方法,以在分配或演示过程中通知 VMR 任何重要的 DirectShow 事件。
IVMRSurfaceAllocatorNotify::RestoreDDrawSurfaces

RestoreDDrawSurfaces 方法通知 VMR 已检测到 DirectDraw Surface“丢失”。
IVMRSurfaceAllocatorNotify::SetBorderColor

SetBorderColor 方法向 VMR 指定在未用于视频的显示矩形区域中要使用的颜色,例如,当视频装箱时。
IVMRSurfaceAllocatorNotify::SetDDrawDevice

SetDDrawDevice 方法设置要用于视频播放的初始 DirectDraw 设备和监视器。

要求

   
最低受支持的客户端 具有 SP1 的 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)

另请参阅

使用视频混合呈现器