ITStream::SelectTerminal-Methode (tapi3if.h)
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 |
|---|---|
|
Methode war erfolgreich. |
|
Der pTerminal-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. |
|
Es wurden mehrere Terminals für den Stream ausgewählt, aber das Mischen oder Teilen von Medien ist nicht möglich. |
|
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) |