Método ITStream::SelectTerminal (tapi3if.h)
El método SelectTerminal selecciona un objeto ITTerminal en la secuencia.
Sintaxis
HRESULT SelectTerminal(
[in] ITTerminal *pTerminal
);
Parámetros
[in] pTerminal
Puntero a la interfaz ITTerminal del terminal seleccionado.
Valor devuelto
Este método puede devolver uno de estos valores.
| Valor | Significado |
|---|---|
|
El método se realizó correctamente. |
|
El parámetro pTerminal no es un puntero válido. |
|
Existe memoria insuficiente para realizar la operación. |
|
Se han seleccionado varios terminales en la secuencia, pero no es posible mezclar o dividir elementos multimedia. |
|
El terminal seleccionado no es válido. |
Comentarios
Los terminales se pueden seleccionar en cualquier momento, independientemente de si el transporte está en un estado que le permite transmitir medios. Si el transporte está en un estado que le permite transmitir medios y la aplicación no ha invocado correctamente ITStream::P auseStream o ITStream::StopStream en la secuencia, o ha invocado correctamente ITStream::StartStream para esta secuencia más recientemente que ha invocado correctamente ITStream::P auseStream o ITStream::StopStream para esta secuencia, el streaming se inicia automáticamente en cuanto se selecciona el terminal. Si se selecciona un terminal en la secuencia antes de que el transporte entre en un estado en el que puede transmitir medios y no se realizan llamadas posteriores a StopStream o PauseStream , la secuencia se inicia automáticamente cuando el transporte entra en un estado en el que puede transmitir medios.
El evento CME_STREAM_ACTIVE se genera cuando se inicia realmente el streaming, que puede ser posterior a la llamada SelectTerminal . El evento CME_STREAM_FAIL o CME_TERMINAL_FAIL se genera cuando se produce un error en el streaming, que también puede ser posterior a la llamada SelectTerminal .
Solo se puede seleccionar un terminal en una secuencia si los resultados de ITTerminal::get_MediaType coinciden con ITStream::get_MediaType. Además, algunos MSP pueden requerir una coincidencia entre ITTerminal::get_Direction y ITStream::get_Direction, aunque la interfaz no lo exige.
Es posible que algunos MSP no permitan que más de un número determinado de terminales, normalmente uno, se seleccionen simultáneamente en la misma secuencia, pero la propia interfaz no aplica ninguna restricción de este tipo. Seleccionar varios terminales a la vez en la misma secuencia es útil, por ejemplo, para permitir la grabación de una secuencia de audio entrante en un archivo mientras escucha la secuencia en un par de altavoces.
Un terminal determinado solo se puede seleccionar en una secuencia.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi3if.h (incluya Tapi3.h) |