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 を含む)
Library Uuid.lib
[DLL] Tapi3.dll

こちらもご覧ください

ITMultiTrackTerminal

ITTerminal