IltmmPlay::get_PreferredVideoRenderer

#include "ltmm.h"

C Syntax

HRESULT IltmmPlay_get_PreferredVideoRenderer(pPlay, pVal)

C++ Syntax

HRESULT get_PreferredVideoRenderer(pVal)

 

IltmmPlay *pPlay;

/* pointer to an interface */

ltmmVideoRenderer *pVal;

/* pointer to a variable */

Retrieves the preferred video renderer.

Parameter

Description

pPlay

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

IltmmPlay::put_PreferredVideoRenderer, ltmmVideoRenderer Constants

Topics:

Multimedia Function Group

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++.