Collapse All Expand All

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.

Required DLLs and Libraries

LTMM For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

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

Example

For a C example, refer to the Simple Media Player for C.

For a C++ example, refer to the Simple Media Player for C++.