IVMRFilterConfig9::SetRenderingMode

  • Article
 
Microsoft DirectShow 9.0

IVMRFilterConfig9::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 VMR9Mode value.

Return Values

The method returns an HRESULT. Possible values include those in the following table.

Value Description
S_OK The method succeeded.
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: Include D3d9.h, Vmr9.h.

Library: Use Strmiids.lib.

See Also