Share via

IMSVidVideoRenderer2::put_SuppressEffects

  • Article
 
Microsoft DirectShow 9.0

IMSVidVideoRenderer2::put_SuppressEffects

This topic applies to Windows XP Service Pack 1 or later.

The put_SuppressEffects method sets preferences for power management and visual effects.

Syntax

  HRESULT put_SuppressEffects(
    VARIANT_BOOL 
  bSuppress
  
  );

Parameters

bSuppress

[in] Specifies a Boolean value. See Remarks for more information.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
S_OK Success.

Remarks

If bSuppress equals VARIANT_TRUE, the Video Control does the following:

  • Disables font smoothing and the system-wide drop shadow effect. (Only when the Video Control is using hardware overlay.) This is useful if the application draws onto the overlay.
  • Disables the screen saver, and turns off power management for the display. This is useful to prevent the operating system from interrupting playback while the user is watching a program.

The Video Control restores the original system settings after it stops.

If bSuppress equals VARIANT_FALSE, the Video Control uses the existing system settings.

Requirements

  Header: Dshow.h.

  Library: Quartz.dll.

See Also