Windows Dev Center

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.

Members

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

Methods

The IVMRSurfaceAllocatorNotify interface has these methods.

MethodDescription
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.

 

Requirements

Minimum supported client

Windows XP with SP1 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Using the Video Mixing Renderer

 

 

Community Additions

ADD
Show:
© 2015 Microsoft