IltmmConvert::put_PreferredVideoRenderer

#include "ltmm.h"

C Syntax

HRESULT IltmmConvert_put_PreferredVideoRenderer(pConvert, newVal)

C++ Syntax

HRESULT put_PreferredVideoRenderer(newVal)

 

IltmmConvert *pConvert;

/* pointer to an interface */

ltmmVideoRenderer newVal;

/* format */

Assigns the preferred video renderer.

Parameter

Description

pConvert

Pointer to an IltmmConvert 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:

IltmmConvert::get_PreferredVideoRenderer, ltmmVideoRenderer Constants

Topics:

Multimedia Function Group

 

Use ltmm Convert to Perform a Convert and Save It as a WMV File

Example

For a C example, refer to Recompressing an AVI File for C.

For a C++ example, refer to Recompressing an AVI File for C++.