CTransformFilter::AlterQuality

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Receives a quality-control notification and provides an opportunity to alter the media stream's quality.

Syntax

virtual HRESULT AlterQuality(
  Quality q 
);

Parameters

• q
  Quality-control notification message.

Return Value

Returns an HRESULT value. S_FALSE means to pass the message to the upstream filter (whether or not any action has been taken).

An overriding member function can return NOERROR to indicate that the message has been handled completely (or as completely as possible) and no further action should be taken.

Remarks

This member function returns S_FALSE by default.

It is called by the CTransformOutputPin::Notify member function before calling the CBaseInputPin::PassNotify member function to pass the quality control message upstream.

If the filter is responsible for affecting the quality of the media stream, override this member function and respond to the quality-notification message.

Requirements