ITStream::SelectTerminal-Methode (tapi3if.h)

  • Artikel

Die SelectTerminal-Methode wählt ein ITTerminal-Objekt im Stream aus.

Syntax

HRESULT SelectTerminal(
  [in] ITTerminal *pTerminal
);

Parameter

[in] pTerminal

Zeiger auf die ITTerminal-Schnittstelle des ausgewählten Terminals.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert Bedeutung
S_OK
 Methode war erfolgreich.
E_POINTER
 Der pTerminal-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY
 Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
TAPI_E_MAXTERMINALS
 Es wurden mehrere Terminals für den Stream ausgewählt, aber das Mischen oder Teilen von Medien ist nicht möglich.
TAPI_E_INVALIDTERMINAL
 Das ausgewählte Terminal ist ungültig.

Hinweise

Terminals können jederzeit ausgewählt werden, unabhängig davon, ob sich der Transport in einem Zustand befindet, der das Streamen von Medien ermöglicht. Wenn sich der Transport in einem Zustand befindet, der das Streamen von Medien zulässt, und die Anwendung itStream::P auseStream oder ITStream::StopStream für den Stream nicht erfolgreich aufgerufen hat oder ITStream::StartStream für diesen Stream in letzter Zeit erfolgreich aufgerufen hat, als ITStream::P auseStream oder ITStream::StopStream für diesen Stream aufgerufen wurde, wird das Streaming automatisch gestartet, sobald das Terminal ausgewählt ist. Wenn ein Terminal für den Stream ausgewählt wird, bevor der Transport in einen Zustand wechselt, in dem Medien gestreamt werden können, und keine nachfolgenden Aufrufe von StopStream oder PauseStream erfolgen, wird der Stream automatisch gestartet, wenn der Transport in einen Zustand wechselt, in dem Medien gestreamt werden können.

Das CME_STREAM_ACTIVE-Ereignis wird generiert, wenn das Streaming tatsächlich gestartet wird, was später als der SelectTerminal-Aufruf sein kann. Das CME_STREAM_FAIL- oder CME_TERMINAL_FAIL-Ereignis wird generiert, wenn das Streaming tatsächlich fehlschlägt. Dies kann auch später als der SelectTerminal-Aufruf erfolgen.

Ein Terminal kann nur in einem Stream ausgewählt werden, wenn die Ergebnisse von ITTerminal::get_MediaTypeMIT ITStream::get_MediaType übereinstimmen. Darüber hinaus erfordern einige MSPs möglicherweise eine Übereinstimmung zwischen ITTerminal::get_Direction und ITStream::get_Direction, obwohl dies von der Schnittstelle nicht erzwungen wird.

Einige MSPs lassen möglicherweise nicht zu, dass mehr als eine bestimmte Anzahl von Terminals (in der Regel eins) gleichzeitig im selben Stream ausgewählt wird, aber die Schnittstelle selbst erzwingt keine solche Einschränkung. Das Gleichzeitige Auswählen mehrerer Terminals für denselben Stream ist z. B. nützlich, um die Aufzeichnung eines eingehenden Audiodatenstroms in einer Datei zu ermöglichen, während der Stream auf einem Lautsprecherpaar abgehört wird.

Ein bestimmtes Terminal kann nur für einen Stream ausgewählt werden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (Tapi3.h einschließen)

Weitere Informationen

ITStream

Media Service Provider Interface (MSPI)