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