ホーム › Devices.Tapi › ITMultiTrackTerminal

ITMultiTrackTerminal

COMIDispatch (デュアル)

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDfe040091-ade8-4072-95c9-bf7de8c54b44継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

ITMultiTrackTerminal インターフェイスは、すべてのマルチトラックターミナルで公開されます。このインターフェイスには、トラックの列挙、作成、削除を行うメソッドが含まれます。ITMultiTrackTerminal インターフェイスは、ITTerminal に対して QueryInterface を呼び出すことで作成されます。

メソッド 6

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_TrackTerminals(VARIANT* pVariant)

get_TrackTerminals メソッドは、このメソッドが呼び出されたマルチトラックターミナルに含まれるターミナルのコレクションを作成して返します。

pVariant

VARIANT*

out

利用可能なトラックの ITTerminal インターフェイスポインターの ITCollection を格納した VARIANT へのポインター。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

値	意味
S_OK	メソッドが成功しました。
E_POINTER	pVariant パラメーターが有効なポインターではありません。
E_OUTOFMEMORY	操作を実行するのに十分なメモリがありません。
E_UNEXPECTED	pVariant パラメーターが空ではありませんでした。

解説(Remarks)

TAPI は、ITMultiTrackTerminal::get_TrackTerminals が返す ITTerminal インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、関連付けられたリソースを解放するために、 ITTerminal インターフェイスに対して Release を呼び出す必要があります。

vtbl 8 HRESULT EnumerateTrackTerminals(IEnumTerminal** ppEnumTerminal)

EnumerateTrackTerminals メソッドは、このメソッドが呼び出されたマルチトラックターミナルに含まれるターミナルの列挙子を作成して返します。

ppEnumTerminal

IEnumTerminal**

out

マルチトラックターミナルに含まれるターミナルを列挙する IEnumTerminal インターフェイスへのポインター。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

値	意味
S_OK	メソッドが成功しました。
E_POINTER	ppTerminalEnum パラメーターが有効なポインターではありません。
E_OUTOFMEMORY	操作を実行するのに十分なメモリがありません。

解説(Remarks)

TAPI は、ITMultiTrackTerminal::EnumerateTrackTerminals が返す IEnumTerminal インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、関連付けられたリソースを解放するために、 IEnumTerminal インターフェイスに対して Release を呼び出す必要があります。

vtbl 9 HRESULT CreateTrackTerminal(INT MediaType, TERMINAL_DIRECTION TerminalDirection, ITTerminal** ppTerminal)

CreateTrackTerminal メソッドは、指定した 1 つまたは複数のメディアタイプおよびメディア方向を処理できるマルチトラックターミナルを作成します。

MediaType	INT	in	ターミナルに必要なメディアタイプのビット単位 OR のリスト。
TerminalDirection	TERMINAL_DIRECTION	in	ターミナルの TERMINAL_DIRECTION 記述子。
ppTerminal	ITTerminal**	out	ITTerminal インターフェイスへのポインター。

戻り値

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

解説(Remarks)

TAPI は、ITMultiTrackTerminal::CreateTrackTerminal が返す ITTerminal インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、関連付けられたリソースを解放するために、 ITTerminal インターフェイスに対して Release を呼び出す必要があります。

vtbl 10 HRESULT get_MediaTypesInUse(INT* plMediaTypesInUse)

get_MediaTypesInUse メソッドは、マルチトラックターミナルが現在管理しているすべてのトラックのメディアタイプ(ビット単位 OR)を返します。

plMediaTypesInUse

INT*

out

使用中のメディアタイプのビット単位 OR のリスト。

戻り値

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

vtbl 11 HRESULT get_DirectionsInUse(TERMINAL_DIRECTION* plDirectionsInUsed)

get_DirectionsInUse メソッドは、マルチトラックターミナルが現在管理しているすべてのトラックの方向を返します。

plDirectionsInUsed

TERMINAL_DIRECTION*

out

方向の TERMINAL_DIRECTION 記述子へのポインター。

戻り値

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

vtbl 12 HRESULT RemoveTrackTerminal(ITTerminal* pTrackTerminalToRemove)

RemoveTrackTerminal メソッドは、このメソッドが呼び出されたマルチトラックターミナルに属するトラックターミナルのコレクションから、指定したターミナルを削除します。

pTrackTerminalToRemove

ITTerminal*

削除するターミナルの ITTerminal インターフェイスへのポインター。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	pTrackTerminalToRemove パラメーターが有効なポインターではありません。
E_OUTOFMEMORY	操作を実行するのに十分なメモリがありません。

解説(Remarks)

RemoveTrackTerminal メソッドの主な用途は、ターミナル選択プロセス中のクリーンアップです。たとえば、トラックが作成されたものの、ストリーム上で選択されていない場合に、このメソッドを使用してそのトラックを削除できます。

このメソッドが実際に実行する動作は、ターミナルの実装によって異なる場合があります。たとえば、ファイル録音ターミナル(File Recording Terminal)でこのメソッドを呼び出すと、対応するファイルデータストリームがファイルから削除されます。ファイル再生ターミナル(File Playback Terminal)でこのメソッドを呼び出すと失敗します。これは、そのターミナルのセットがファイル構成のみによって決定され、呼び出し元が変更できないためです。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ITMultiTrackTerminal "{FE040091-ADE8-4072-95C9-BF7DE8C54B44}"
#usecom global ITMultiTrackTerminal IID_ITMultiTrackTerminal "{}"
#comfunc global ITMultiTrackTerminal_get_TrackTerminals       7 var
#comfunc global ITMultiTrackTerminal_EnumerateTrackTerminals  8 sptr
#comfunc global ITMultiTrackTerminal_CreateTrackTerminal      9 int,int,sptr
#comfunc global ITMultiTrackTerminal_get_MediaTypesInUse      10 var
#comfunc global ITMultiTrackTerminal_get_DirectionsInUse      11 var
#comfunc global ITMultiTrackTerminal_RemoveTrackTerminal      12 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ITMultiTrackTerminal "{FE040091-ADE8-4072-95C9-BF7DE8C54B44}"
#usecom global ITMultiTrackTerminal IID_ITMultiTrackTerminal "{}"
#comfunc global ITMultiTrackTerminal_get_TrackTerminals       7 sptr
#comfunc global ITMultiTrackTerminal_EnumerateTrackTerminals  8 sptr
#comfunc global ITMultiTrackTerminal_CreateTrackTerminal      9 int,int,sptr
#comfunc global ITMultiTrackTerminal_get_MediaTypesInUse      10 sptr
#comfunc global ITMultiTrackTerminal_get_DirectionsInUse      11 sptr
#comfunc global ITMultiTrackTerminal_RemoveTrackTerminal      12 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。