itMultiTrackTerminal：：RemoveTrackTerminal 方法 (tapi3if.h)

RemoveTrackTerminal 方法从属于调用该方法的多轨终端的轨道终端集合中删除指定的终端。如果已在流中选择跟踪终端，则应先取消选择它。

语法

HRESULT RemoveTrackTerminal(
  [in] ITTerminal *pTrackTerminalToRemove
);

[in] pTrackTerminalToRemove

指向要删除的终端的 ITTerminal 接口的指针。

此方法可以返回其中一个值。

返回代码	说明
S_OK	方法成功。
E_POINTER	pTrackTerminalToRemove 参数不是有效的指针。
E_OUTOFMEMORY	内存不足，无法执行操作。

RemoveTrackTerminal 方法的主要用途是在终端选择过程中进行清理。例如，如果已创建曲目，但尚未在流中选择它，则此方法可用于删除该曲目。

此方法执行的实际操作可能因终端的实际实现而异。例如，在文件录制终端上调用此方法会导致从文件中删除相应的文件数据流。在文件播放终端上调用此方法失败，因为其终端集完全由文件配置决定，调用方无法更改。