LEADTOOLS Multimedia Features > Multimedia Function References > IltmmPlay Interface > IltmmPlay::put_PreferredVideoRenderer

IltmmPlay::put_PreferredVideoRenderer

#include "ltmm.h"

C Syntax	HRESULT IltmmPlay_put_PreferredVideoRenderer(pPlay, newVal)
C++ Syntax	HRESULT put_PreferredVideoRenderer(newVal)

IltmmPlay *pPlay;	pointer to an interface
ltmmVideoRenderer newVal;	format

Assigns the preferred video renderer.

Parameter	Description
pPlay	Pointer to an IltmmPlay interface.
newVal	Value that is one of the ltmmVideoRenderer Constants.

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This function sets the preferred video renderer. The default value is ltmmVideoRenderer_VMR9.

LEADTOOLS will automatically try the assigned video renderer preference. If that fails, then LEADTOOLS will step down to an earlier version of the renderer, until all renderers are exhausted.

If you are on a system that supports VMR7 or VMR9, then the Legacy renderer is not automatically attempted unless the user explicitly sets Legacy as a preference. This prevents screen flashing on these systems.

Elements:	IltmmPlay::get_PreferredVideoRenderer, ltmmVideoRenderer Constants
Topics:	Multimedia Function Group
	Use ltmm Play to Perform a Play and Save It as a WMV File

IltmmPlay::put_PreferredVideoRenderer

Returns

Comments

Example