Microsoft DirectX 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.