ISBE2StreamMap::MapStream method (sbe.h)

Article
12/05/2018

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

Maps a stream to an output pin for a Stream Buffer Source filter.

By default, the stream mappings cannot be changed. Before calling this method, disable the default mapping mode by calling the ISBE2Crossbar::EnableDefaultMode method without the DEF_MODE_STREAMS flag.

Syntax

HRESULT MapStream(
  [in] SBE2_STREAM_ID Stream
);

Parameters

[in] Stream

Identifier for the stream mapped to an output pin. The major type of the stream must match the major type of the pin.

Return value

Return code/value	Description
S_OK	Success.
E_FAIL	The specified stream has already been mapped to a pin.
E_UNEXPECTED	Cannot unmap the stream, because the default mode is enabled.
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) 0x80070490	No stream exists with the specified stream identifier.

Remarks

If the new stream has different media type from the previously mapped stream, the output pin follows the dynamic format change procedure described in Dynamic Format Changes, and flushes downstream pins as described in Flushing.

Requirements

Requirement	Value
Minimum supported client	Windows�7 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	sbe.h

Share via