ITMultiTrackTerminal::RemoveTrackTerminal 方法 (tapi3if.h)

RemoveTrackTerminal 方法會從屬於呼叫 方法的多追蹤終端機集合中移除指定的終端機。 如果已在數據流上選取追蹤終端機,則應該先取消選取。

語法

HRESULT RemoveTrackTerminal(
  [in] ITTerminal *pTrackTerminalToRemove
);

參數

[in] pTrackTerminalToRemove

要移除之終端機 之 ITTerminal 介面的指標。

傳回值

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

傳回碼 描述
S_OK
方法成功。
E_POINTER
pTrackTerminalToRemove 參數不是有效的指標。
E_OUTOFMEMORY
記憶體不足,無法執行作業。

備註

RemoveTrackTerminal 方法的主要用法是在終端機選取程式期間清除。 例如,如果已建立追蹤,但尚未在數據流上選取,則這個方法可用來移除追蹤。

此方法執行的實際動作可能會因終端機的實際實作而有所不同。 例如,在檔案錄製終端機上呼叫這個方法會導致從檔案中移除對應的檔案數據流。 在檔案播放終端機上呼叫這個方法會失敗,因為其終端機集只由檔案組態決定,而且呼叫端無法變更。

規格需求

需求
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)
程式庫 Uuid.lib
Dll Tapi3.dll

另請參閱

ITMultiTrackTerminal

ITTerminal