Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 IQualityControlinterface.

Otherwise, returns the HRESULTvalue 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 PassNotifymember function is called from the CTransformOutputPin::Notifymember function when a notification requires passing. The Qualitystructure passed is the one that the output pin received.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment,
Version 2.12 requires DXPAK 1.0 or later