Share via


ISBE2StreamMap::MapStream method (sbe.h)

[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

See also

ISBE2Crossbar

ISBE2Crossbar::EnableDefaultMode

ISBE2StreamMap

Stream Buffer Source Filter