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.