COutputQueue::NewSegment (Windows CE 5.0)

Send Feedback

Queues an IPin::NewSegment call to the connected input pin after all queued samples have been passed to the input pin.

HRESULT NewSegment(REFERENCE_TIMEtStart,REFERENCE_TIMEtStop,doubledRate);

Parameters

  • tStart
    [in] Start time of the segment.
  • tStop
    [in] Stop time of the segment.
  • dRate
    [in] Rate of the segment.

Return Values

Returns an HRESULT value.

Remarks

This member function calls the IPin::NewSegment method on the output pin after all previous data has been delivered.

Like COutputQueue::EOS, the COutputQueue::NewSegment call and its parameters are queued as a special control sample if the COutputQueue object is in queued mode, and the IPin::NewSegment method is called from the worker thread in COutputQueue::ThreadProc.

Special control samples, as implemented by this member function, are only relevant if you plan to change or extend the default base class implementation of COutputQueue in a derived class. Normal use of the COutputQueue class does not require the use of control samples.

This member function allows filters that process buffers containing more than one sample to delineate the rendering of the samples between start and stop time, as indicated by the tStart and tStop parameters.

COutputQueue::NewSegment is intended to be implemented on an input pin. A connected output pin on the upstream filter calls this member function after completing delivery of previous data and before calling IMemInputPin::Receive with any new data. It indicates that all data arriving after this call is part of a segment delineated by the parameters.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.