CTransformOutputPin.Notify method

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The Notify method notifies the pin that a quality change is requested. This method implements the IQualityControl::Notify method.

Syntax

HRESULT Notify(
   IBaseFilter *pSelf,
   Quality     q
);

Parameters

pSelf

Pointer to the IBaseFilter interface of the filter that delivered the quality control message.

q

Quality structure that contains the quality control message.

Return value

Returns an HRESULT value. Possible values include those shown in the following table.

Return code Description
S_OK
Success.
VFW_E_NOT_FOUND
Could not find an object to accept the message.

Remarks

This method calls the filter's CTransformFilter::AlterQuality method. If the filter does not handle the quality message, this method calls the CBaseInputPin::PassNotify method on the filter's input pin. The PassNotify method passes the quality message upstream (or to a custom quality manager, if one was installed).

Requirements

Requirement Value
Header
Transfrm.h (include Streams.h)
Library
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)