IVMRSurfaceAllocator Interface

 
Microsoft DirectShow 9.0

IVMRSurfaceAllocator Interface

The IVMRSurfaceAllocator interface is implemented by the default allocator-presenter for the Video Mixing Renderer Filter 7 (VMR-7). It must also be implemented by any plug-in allocator-presenter that an application provides to the VMR-7. The VMR-7 uses the methods on this interface to allocate, prepare and free DirectDraw surfaces. Applications do not use this interface.

For the VMR-9, use the IVMRSurfaceAllocator9 interface.

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

Method Description
AdviseNotify Called by the VMR to provide the allocator-presenter with an interface pointer for notification callbacks.
AllocateSurface Allocates a DirectDraw surface.
FreeSurface Frees the allocated DirectDraw surface.
PrepareSurface Prepares the DirectDraw surface to have the next video frame decoded into it.

Requirements

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

Library: Use Strmiids.lib.