#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. |
Win32, x64
See Also
Elements: |
IltmmPlay::get_PreferredVideoRenderer, ltmmVideoRenderer Constants |
Topics: |
|
|
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++.