IVMRSurfaceAllocatorNotify Interface

Microsoft DirectShow 9.0

IVMRSurfaceAllocatorNotify Interface

The IVMRSurfaceAllocatorNotify ** interface is implemented by the Video Mixing Renderer Filter 7 (VMR-7). Applications use this interface to set a custom allocator-presenter and the allocator-presenter uses this interface to inform the VMR-7 of changes to the system environment that affect the DirectDraw surfaces.

In order for an application to obtain this interface, the VMR must be in renderless mode.

For the VMR-9, use the IVMRSurfaceAllocatorNotify9 interface.

In addition to the methods inherited from IUnknown, the IVMRSurfaceAllocatorNotify interface exposes the following methods:

Method	Description
AdviseSurfaceAllocator	Called by an application to instruct the VMR to use a custom allocator-presenter.
ChangeDDrawDevice	Notifies the VMR that the DirectDraw playback device has changed.
NotifyEvent	Called by the allocator-presenter to inform the VMR of any significant DirectShow events during the allocation or presentation processes.
RestoreDDrawSurfaces	Notifies the VMR that a DirectDraw surface "loss" has been detected.
SetBorderColor	Specifies to the VMR which color to use in areas of the display rectangle which are not being used for video, for example when the video is letterboxed.
SetDDrawDevice	Sets the initial DirectDraw device and monitor to be used for video playback.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.