Collapse All Expand All

IltmmCapture::get_PreferredVideoRenderer

#include "ltmm.h"

C Syntax	HRESULT IltmmCapture_get_PreferredVideoRenderer(pCapture, pVal)
C++ Syntax	HRESULT get_PreferredVideoRenderer(pVal)

 

IltmmCapture *pCapture;	/* pointer to an interface */
ltmmVideoRenderer *pVal;	/* pointer to a variable */

Retrieves the preferred video renderer.

Parameter	Description
pCapture	Pointer to an IltmmCapture interface.
pVal	Pointer to a variable that receives 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 returns the preferred video renderer assigned with the put_PreferredVideoRenderer function. 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.

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::put_PreferredVideoRenderer, ltmmVideoRenderer Constants
Topics:	Multimedia Function Group

Example

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

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