Edit

Share via

ITSubStream::UnselectTerminal method (tapi3if.h)

  • Article

The UnselectTerminal method unselects the terminal from the substream.

Syntax

HRESULT UnselectTerminal(
  [in] ITTerminal *pTerminal
);

Parameters

[in] pTerminal

Pointer to ITTerminal interface terminal to remove from stream.

Return value

This method can return one of these values.

Value Meaning
S_OK
 Method succeeded.
E_POINTER
 The pTerminal parameter is not a valid pointer.
E_OUTOFMEMORY
 Insufficient memory exists to perform the operation.
TAPI_E_INVALIDTERMINAL
 The pTerminal parameter does not point to a valid terminal.
TAPI_E_NOTSUPPORTED
 The provider does not support this operation.

Remarks

Some stream events may be received after streaming has been stopped due to delayed transmission.

Successfully unselecting the last terminal from a substream effectively ceases any existing streaming for this particular substream. Subsequently selecting the same terminal or another terminal restarts such interrupted streaming.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)

See also

ITSubStream

Media Service Provider Interface (MSPI)