| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The IVMRSurfaceAllocatorNotify interface is implemented by the DirectShow VMR filter. Applications use this interface to set a custom allocator-presenter and the allocator-presenter uses this interface to inform the VMR of changes to the system environment that affect the DirectDraw surfaces.
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 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. |