IVMRFilterConfig::SetRenderingPrefs method

The SetRenderingPrefs method sets various application preferences related to video rendering.

Syntax


HRESULT SetRenderingPrefs(
  [in] DWORD dwRenderFlags
);

Parameters

dwRenderFlags [in]

Double word containing a bitwise OR of VMRRenderPrefs values specifying the rendering preferences.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Return codeDescription
VFW_E_WRONG_STATE

No allocator-presenter is present.

E_INVALIDARG

dwRenderFlags is invalid.

 

Remarks

This method calls through to the allocator-presenter's IVMRImagePresenterConfig::SetRenderingPrefs method. (The default allocator-presenter exposes IVMRImagePresenterConfig. Custom allocator-presenters can also expose this interface if desired.) If the VMR-7 has not yet created the default allocator-presenter, or if the application provided a custom allocator-presenter which does not support IVMRImagePresenterConfig, this method returns VFW_E_WRONG_STATE. To create the default allocator-presenter, call IVMRFilterConfig::SetRenderingMode with the value VMRMode_Windowed or VMRMode_Windowed.

Requirements

Minimum supported client

Windows XP with SP1 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Error and Success Codes
Using the Video Mixing Renderer
IVMRFilterConfig Interface
IVMRFilterConfig::GetRenderingPrefs

 

 

Show: