IVMRSurfaceAllocator interface (strmif.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

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.

Inheritance

The IVMRSurfaceAllocator interface inherits from the IUnknown interface. IVMRSurfaceAllocator also has these types of members:

Methods

The IVMRSurfaceAllocator interface has these methods.

IVMRSurfaceAllocator::AdviseNotify The AdviseNotify method provides the allocator-presenter with the VMR-7 filter's interface for notification callbacks.
IVMRSurfaceAllocator::AllocateSurface The AllocateSurface method allocates a DirectDraw surface.
IVMRSurfaceAllocator::FreeSurface The FreeSurface method frees the allocated DirectDraw surface.
IVMRSurfaceAllocator::PrepareSurface The PrepareSurface method prepares the DirectDraw surface to have the next video frame decoded into it.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP1 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	strmif.h (include Dshow.h)

See also

Using the Video Mixing Renderer