CBaseInputPin::EndFlush

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Informs the pin to end a flush operation and notifies the pin that it can start accepting data again.

Syntax

HRESULT EndFlush(void);

Parameters

None.

Return Value

Returns an HRESULT value.

Remarks

This member function implements the IPin::EndFlush method.

When this method is called, the pin is beginning to end a flush operation. Your derived class must override this member function, but should call this member function at the end of your implementation to clear m_bFlushing so that IMemInputPin::Receive calls will succeed.

Before calling this base class implementation, your overriding member function should perform the following steps.

Ensure that your filter will not push any additional data. (To do this, synchronize with a thread, stop it pushing, and discard any queued data.)

Pass the EndFlush method downstream by calling the method on the downstream filter's input pin.

IPin::EndFlush is not logically part of the media stream. It can be optimized in the sense that if a pin has passed no data downstream before this method is called, there is no need to pass this notification on.

An example of an overriding implementation of this member function can be found in the CTransformInputPin::EndFlush member function, which uses the CBaseOutputPin::DeliverEndFlush member function to perform the last step.

Requirements