IPin::EndFlush

  • Articolo
 
Microsoft DirectShow 9.0

IPin::EndFlush

The EndFlush method ends a flush operation.

Applications should not call this method. This method is called by other filters, to flush data from the graph.

Syntax

  HRESULT EndFlush(void);

Return Value

Returns an HRESULT value. Possible values include the following.

Value Description
S_OK Success.
E_UNEXPECTED The pin is an output pin.

Remarks

Call this method only on input pins. Output pins return E_UNEXPECTED.

When this method is called, the filter performs the following actions:

  1. Waits for all queued samples to be discarded.
  2. Frees any buffered data, including any pending end-of-stream notifications.
  3. Clears any pending EC_COMPLETE notifications.
  4. Calls EndFlush downstream.

When the method returns, the pin can accept new samples.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also