IMSVidVideoRenderer2::put_SuppressEffects

This topic applies to Windows XP Service Pack 1 only.

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.

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.

Return Values

Returns an HRESULT value. Possible values include the following.

See Also

• IMSVidVideoRenderer2 Interface
• IMSVidVideoRenderer::put_UsingOverlay