ITStream::UnselectTerminal method (tapi3if.h)
The UnselectTerminal method unselects the terminal from the stream and stops streaming for this stream.
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 |
|---|---|
|
Method succeeded. |
|
The pTerminal parameter is not a valid pointer. |
|
Insufficient memory exists to perform the operation. |
|
The pTerminal parameter does not point to a valid terminal. |
|
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 stream effectively ceases any existing streaming for this particular stream. Subsequently selecting the same terminal or another terminal restarts such interrupted streaming.
Reselection onto a stream with a different terminal, or a newly created one, can have unexpected effects. The filter graph may retain information from the previous terminal that fails to match the new one.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (include Tapi3.h) |