共用方式為

ITStream：：SelectTerminal 方法 (tapi3if.h)

  • 發行項

SelectTerminal 方法會將 ITTerminal 物件選取至數據流。

語法

HRESULT SelectTerminal(
  [in] ITTerminal *pTerminal
);

參數

[in] pTerminal

所選終端機之 ITTerminal 介面的指標。

傳回值

這個方法可以傳回下列其中一個值。

值 意義
S_OK
 方法成功。
E_POINTER
 pTerminal 參數不是有效的指標。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。
TAPI_E_MAXTERMINALS
 數據流上已選取多個終端機，但無法進行媒體混合或分割。
TAPI_E_INVALIDTERMINAL
 選取的終端機無效。

備註

無論傳輸是否處於允許串流媒體的狀態，隨時都可以選取終端機。 如果傳輸處於可串流處理媒體的狀態，而且應用程式尚未成功叫用 數據流上的ITStream：:P auseStream 或 ITStream：：StopStream ，或已成功叫用此數據流的 ITStream：：StartStream ，比已成功叫用 ITStream：:P auseStream 或 ITStream：：StopStream， 然後在選取終端機時自動啟動串流。 如果在傳輸進入可串流媒體的狀態之前，在數據流上選取終端機，而且不會對 StopStream 或 PauseStream 進行後續呼叫，則當傳輸進入可串流媒體的狀態時，數據流會自動啟動。

串流實際啟動時會產生CME_STREAM_ACTIVE事件，這可能晚於 SelectTerminal 呼叫。 當串流實際失敗時，會產生CME_STREAM_FAIL或CME_TERMINAL_FAIL事件，也可能晚於 SelectTerminal 呼叫。

只有在 ITTerminal：：get_MediaType 的結果符合 ITStream：：get_MediaType時，才能選取終端機。 此外，某些 MSP 可能需要 在 ITTerminal：：get_Direction 和 ITStream：：get_Direction之間相符，但介面不會強制執行此動作。

某些 MSP 可能不允許在相同數據流上同時選取一個以上的終端機數目，但介面本身不會強制執行任何這類限制。 例如，在同一個數據流上一次選取多個終端機很有用，例如，允許在一對喇叭上接聽串流時，將傳入音訊串流錄製到檔案。

指定的終端機只能選取至一個數據流。

規格需求

需求 值
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)

另請參閱

ITStream

媒體服務提供者介面 (MSPI)