Collapse All Expand All

IltmmCapture::put_PreferredVideoRenderer

#include "ltmm.h"

C Syntax	HRESULT IltmmCapture_put_PreferredVideoRenderer(pCapture, newVal)
C++ Syntax	HRESULT put_PreferredVideoRenderer(newVal)

 

IltmmCapture *pCapture;	/* pointer to an interface */
ltmmVideoRenderer newVal;	/* format */

Assigns the preferred video renderer.

Parameter	Description
pCapture	Pointer to an IltmmCapture 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:	IltmmCapture::get_PreferredVideoRenderer, ltmmVideoRenderer Constants
Topics:	Multimedia Function Group
	Use ltmm Capture to Perform a Capture and Save It as a WMV File

Example

For a C example, refer to Advanced Capture Application for C.

For a C++ example, refer to Advanced Capture Application for C++.