CBaseInputPin::PassNotify

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Passes a quality-control notification to the appropriate sink.

Syntax

HRESULT PassNotify(
  Quality q
);

Parameters

• q
  Quality-control notification object.

Return Value

Returns VFW_E_NOT_FOUND if no quality sink is set and the upstream filter does not support the IQualityControl interface.

Otherwise, returns the HRESULT value resulting from notifying the sink or the upstream filter.

Remarks

Output pins receive quality-control notifications and, if possible, filters act on them to degrade appropriately. Often, filters cannot respond to the notifications; in this case the notification should be passed to the quality-control sink or, by default, upstream to the next filter.

The PassNotify member function is called from the CTransformOutputPin::Notify member function when a notification requires passing. The Quality structure passed is the one that the output pin received.

Requirements