ITStream::StopStream method

The StopStream method stops the stream.

Syntax


HRESULT StopStream();

Parameters

This method has no parameters.

Return value

This method can return one of these values.

ValueMeaning
S_OK

Method succeeded.

E_NOTIMPL

Method not implemented.

TAPI_E_NOTSUPPORTED

The provider does not support this operation.

 

Remarks

An application can call this method to stop a stream. The difference between pausing a stream and stopping a stream depends on the type of transport used for the call.

This call generates events that the application can retrieve if it has registered. Please see the Events overview for information on receiving events.

If the stream stops successfully, the application receives a CALL_MEDIA_EVENT with a value of CME_STREAM_INACTIVE event and CALL_MEDIA_EVENT_CAUSE equaling CMC_LOCAL_REQUEST.

If the stream fails to pause, the application receives a CME_STREAM_FAIL event with cause CMC_LOCAL_REQUEST.

To subsequently restart the stream, the application must call StartStream.

Requirements

TAPI version

Requires TAPI 3.0 or later

Header

Tapi3.h

See also

Media Service Provider Interface (MSPI)
ITStream

 

 

Community Additions

ADD
Show:
© 2014 Microsoft