IVMRFilterConfig::SetRenderingMode
| Microsoft DirectShow 9.0 |
IVMRFilterConfig::SetRenderingMode
The SetRenderingMode method sets the rendering mode used by the VMR.
Syntax
HRESULT SetRenderingMode( DWORD Mode );
Parameters
Mode
[in] Specifies the rendering mode as a VMRMode value.
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
| Error Code | Description |
| E_INVALIDARG | An invalid rendering mode was specified. |
| VFW_E_WRONG_STATE | The mode cannot be changed for some reason. See Remarks. |
Remarks
The VMR is in VMRMode_Windowed by default. Use this method only if you are putting the VMR into VMRMode_Windowless or VMRMode_Renderless mode**.** You cannot change the mode after any pin has been connected and you cannot change the mode from windowless or renderless back to windowed, even before any pins are connected. Therefore, specifying VMRMode_Windowed for Mode has no effect under any circumstances.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also