Export (0) Print
Expand All

IVMRFilterConfig9::SetRenderingMode method

The SetRenderingMode method sets the rendering mode used by the VMR.

Syntax


HRESULT SetRenderingMode(
  [in]  DWORD Mode
);

Parameters

Mode [in]

Specifies the rendering mode as a VMR9Mode value.

Return value

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

Return codeDescription
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 windowed mode (VMR9Mode_Windowed) by default. Use this method to put the VMR into windowless mode (VMR9Mode_Windowless) or renderless mode (VMR9Mode_Renderless).

The mode cannot be changed after any pin has been connected. Also, the mode cannot be changed from windowless or renderless mode back to windowed mode, even before pins are connected. Therefore, specifying VMR9Mode_Windowed for the Mode parameter has no effect under any circumstances.

Requirements

Minimum supported client

Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Vmr9.h

Library

Strmiids.lib

See also

IVMRFilterConfig9 Interface
Using the Video Mixing Renderer
VMR Modes of Operation

 

 

Community Additions

ADD
Show:
© 2014 Microsoft