Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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) |