CBasePin::SetSink

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Sets the object containing the IQualityControl interface that will receive quality-control messages.

Syntax

HRESULT SetSink(
  IQualityControl* piqc
);

Parameters

• piqc
  Pointer to the IQualityControl interface that notifications should be sent to.

Return Value

Base class returns NOERROR by default.

The overriding member function should return an HRESULT value.

Remarks

This member function implements the IQualityControl::SetSink method.

The default implementation sets the m_pQSink data member to the piqc parameter passed in.

The IQualityControl::SetSink method tells a filter where to send quality-control messages it receives.

When no sink has explicitly been set or if the last call to CBasePin::SetSink set the sink to NULL, the message should go upstream.

The derived output pin class typically overrides CBasePin::Notify to enable this.

Requirements