Share via


Stream Buffer Source Filter

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

This topic applies only to Windows XP Service Pack 1 or later.

The Stream Buffer Source filter is the source filter for the Stream Buffer Engine. It reads content that the Stream Buffer Sink filter or Stream Buffer Sink2 filter has stored.

Filter Interfaces
[IAMFilterMiscFlags](/windows/win32/api/strmif/nn-strmif-iamfiltermiscflags)
[IBaseFilter](/windows/win32/api/strmif/nn-strmif-ibasefilter)
[IFileSourceFilter](/windows/win32/api/strmif/nn-strmif-ifilesourcefilter)
ISpecifyPropertyPages
[IStreamBufferMediaSeeking](/previous-versions/windows/desktop/api/Sbe/)
[IStreamBufferMediaSeeking2](/previous-versions/windows/desktop/api/Sbe/nn-sbe-istreambuffermediaseeking2)
[IStreamBufferInitialize](/previous-versions/windows/desktop/api/Sbe/nn-sbe-istreambufferinitialize)
[IStreamBufferSource](/previous-versions/windows/desktop/api/Sbe/nn-sbe-istreambuffersource)
[ISBE2GlobalEvent](/previous-versions/windows/desktop/api/sbe/nn-sbe-isbe2globalevent)
[ISBE2SpanningEvent](/previous-versions/windows/desktop/api/sbe/nn-sbe-isbe2spanningevent)
[ISBE2Crossbar](/previous-versions/windows/desktop/api/sbe/nn-sbe-isbe2crossbar)
Input Pin Media Types Not applicable
Input Pin Interfaces Not applicable
Output Pin Media Types All audio, video, and data types accepted
Output Pin Interfaces
[IMediaSeeking](/windows/win32/api/strmif/nn-strmif-imediaseeking) (see Remarks)
[IPin](/windows/win32/api/strmif/nn-strmif-ipin)
[IQualityControl](/windows/win32/api/strmif/nn-strmif-iqualitycontrol)
[IStreamBufferDataCounters](/previous-versions/windows/desktop/api/Sbe/nn-sbe-istreambufferdatacounters)
[ISBE2StreamMap](/previous-versions/windows/desktop/api/sbe/nn-sbe-isbe2streammap)
Filter CLSID CLSID_StreamBufferSource
Property Page CLSID Not applicable
Executable Sbe.dll
Merit MERIT_DO_NOT_USE
Category CLSID_LegacyAmFilterCategory

Remarks

The Stream Buffer Source filter supports the IMediaSeeking interface for completed recordings only. For live content, use the IStreamBufferMediaSeeking interface, which has the same methods but slightly different behavior for each method. This reflects the fact that live content continuously grows on one end, as the show is being recorded, and shrinks on the other end, as backing files are deleted. See the description of the IStreamBufferMediaSeeking interface for details.

You can use the IStreamBufferMediaSeeking interface with completed recordings, but do not mix IStreamBufferMediaSeeking calls and IMediaSeeking calls. After the first call to an IStreamBufferMediaSeeking method, the filter will fail any subsequent calls to IMediaSeeking methods and will also fail any subsequent QueryInterface calls for the IMediaSeeking interface.

To use the IStreamBufferMediaSeeking methods, an application should query the filter directly. To use the IMediaSeeking methods, the application should query the Filter Graph Manager. The Filter Graph Manager routes the seek commands to the filter, as described in Seeking.

Beginning with Windows Media Center TV Pack 2008 and Windows 7, the Stream Buffer Source filter supports the .WTV file format. H.264 is added as the default supported media type. Several new interfaces are also added to the filter:

  • The ISBE2GlobalEvent and ISBE2SpanningEvent interfaces offer the ability to obtain event data from global spanning events and in-band spanning events, respectively. A global spanning event sends state information that applies to all streams in the pipeline. An in-band spanning event is an in-band event that can be recorded as part of the state information in a stream. For more information how to obtain data from global spanning events, see Receiving Spanning Events in the Stream Buffer Engine.
  • The ISBE2Crossbar interface provides the ability to define profiles of all media types (corresponding to output pins) for a Stream Buffer Source filter.
  • The ISBE2StreamMap interface provides the ability to enumerate streams that are available for mapping to a Stream Buffer Source filter's output pins, and specify custom mappings between streams and output pins.

For more information on crossbars, profiles, and stream mappings, see Stream Buffer Source Filter Enhancements in Windows 7.

Receiving Spanning Events in the Stream Buffer Engine

Stream Buffer Engine Filters

Using the Stream Buffer Engine