Share via


ISBE2StreamMap::UnmapStream 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.]

Removes the mapping between a stream and an output pin for a Stream Buffer Source filter. After a successful call to this method, the output pin stops sending media samples. To resume sending media samples, the pin must be mapped to another stream by a call to the MapStream method.

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 UnmapStream(
  [in] SBE2_STREAM_ID Stream
);

Parameters

[in] Stream

Identifier for the stream. This stream will be unmapped from the output pin.

Return value

Return code Description
S_FALSE
The specified stream does not exist or was not previously mapped to a pin.
S_OK
Success.
E_UNEXPECTED
Cannot unmap the stream, because the default mode is enabled.

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

ISBE2StreamMap::MapStream