CPullPin::Receive

 
Microsoft DirectShow 9.0

CPullPin::Receive

The Receive method is called when the object receives a media sample from the output pin. The derived class must implement this method.

Syntax

  virtual HRESULT Receive(
    IMediaSample *pSample
) PURE;

Parameters

pSample

Pointer to the IMediaSample interface of the media sample.

Return Values

Returns an HRESULT value. Returning a value other than S_OK will stop the data-pulling thread.

Remarks

This method is called whenever a new sample arrives from the output pin. Write this method in the same manner as the IMemInputPin::Receive method.

The time stamps on the sample specify the byte offsets, relative to the original start position that was specified in CPullPin::Seek method.

The start position is rounded down to the nearest alignment boundary, and the stop position is rounded up to the nearest alignment boundary. Also, if the stop position exceeds the total duration, the duration is used instead.

All time stamps are given as a byte offset multiplied by 10,000,000, defined as the constant UNITS. Thus, notionally one second is one byte. To find the actual byte offsets, call IMediaSample::GetTime and divide the results by UNITS.

Requirements

**  Header:** Include Pullpin.h and Streams.h.

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

See Also