Metodo ITStream::SelectTerminal (tapi3if.h)
Il metodo SelectTerminal seleziona un oggetto ITTerminal nel flusso.
Sintassi
HRESULT SelectTerminal(
[in] ITTerminal *pTerminal
);
Parametri
[in] pTerminal
Puntatore all'interfaccia ITTerminal del terminale selezionato.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Valore | Significato |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro pTerminal non è un puntatore valido. |
|
Memoria insufficiente per eseguire l'operazione. |
|
Più terminali sono stati selezionati nel flusso, ma la combinazione o la suddivisione dei supporti non è possibile. |
|
Il terminale selezionato non è valido. |
Commenti
I terminali possono essere selezionati in qualsiasi momento, indipendentemente dal fatto che il trasporto sia in uno stato che consente di trasmettere supporti. Se il trasporto si trova in uno stato che lo consente di trasmettere supporti e l'applicazione non ha richiamato correttamente ITStream::P auseStream o ITStream: :StopStream nel flusso o ha richiamato correttamente ITStream::StartStream per questo flusso più di recente di quanto abbia richiamato correttamente ITStream::P auseStream o ITStream :: StopStream per questo flusso, lo streaming viene avviato automaticamente non appena viene selezionato il terminale. Se un terminale viene selezionato nel flusso prima che il trasporto entri in uno stato in cui può trasmettere supporti e non vengono eseguite chiamate successive a StopStream o PauseStream , il flusso viene avviato automaticamente quando il trasporto entra in uno stato in cui può trasmettere i supporti.
L'evento CME_STREAM_ACTIVE viene generato quando lo streaming viene effettivamente avviato, che può essere successivo alla chiamata SelectTerminal . L'evento CME_STREAM_FAIL o CME_TERMINAL_FAIL viene generato quando lo streaming ha esito negativo, che può anche essere successivo alla chiamata SelectTerminal .
Un terminale può essere selezionato in un flusso solo se i risultati di ITTerminal::get_MediaType corrispondono a ITStream::get_MediaType. Inoltre, alcuni PROVIDER di servizi di configurazione possono richiedere una corrispondenza tra ITTerminal::get_Direction e ITStream::get_Direction, anche se l'interfaccia non applica questa operazione.
Alcuni provider di servizi di sicurezza potrebbero non consentire più di un certo numero di terminali, in genere uno, di essere selezionati simultaneamente nello stesso flusso, ma l'interfaccia stessa non applica alcuna restrizione. La selezione di più terminali alla volta nello stesso flusso è utile, ad esempio, per consentire la registrazione di un flusso audio in ingresso in un file durante l'ascolto del flusso su una coppia di altoparlanti.
Un determinato terminale può essere selezionato in un solo flusso.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h (includere Tapi3.h) |