CPullPin Class

The CPullPin class provides support for input pins that pull data through the IAsyncReader interface. Use this class if you are implementing a filter that uses the pull model to request data from the upstream filter. For more information, see Data Flow in the Filter Graph and Pull Model.

This class does not derive from CBasePin or implement the IPin interface, and some of the method names clash with IPin, so it is best used as a helper object inside your pin. To use this class, do the following:

1. Derive a helper class from CPullPin, and derive an input pin class from CBasePin. Declare an instance of the CPullPin object as a member variable of the pin class.
2. Override the CBasePin::CheckConnect method to call CPullPin::Connect. This method queries the other pin for IAsyncReader.
3. Override the CBasePin::BreakConnect method to call CPullPin::Disconnect.
4. Override the CBasePin::Active method to call CPullPin::Active. This method starts up a worker thread that pulls samples from the upstream filter. When the pins connect, you can specify whether you want the worker thread to make asynchronous or synchronous read requests.
5. Override the CBasePin::Inactive method to call CPullPin::Inactive. This method shuts down the worker thread.
6. Implement the pure virtual CPullPin::Receive method to process incoming samples and deliver them downstream.
7. To set the stop and start positions, or to seek the stream, call the CPullPin::Seek method. This method pauses the worker thread and flushes the filter graph.
8. Implement the pure virtual CPullPin::EndOfStream, CPullPin::BeginFlush, and CPullPin::EndFlush methods, as described in the remarks for those methods.
9. Implement the pure virtual CPullPin::OnError method to handle streaming errors.

Requirements

Header: Include Pullpin.h and Streams.h.

Library: Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).