ITLegacyCallMediaControl
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
ITLegacyCallMediaControl インターフェイスは、デバイスと直接通信する必要があるレガシー アプリケーションをサポートします。このインターフェイスは Call オブジェクト上で公開され、ITBasicCallControl に対して QueryInterface を呼び出すことで作成できます。
メソッド 5
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
DetectDigits メソッドは、現在のコールで検出される桁(ロータリー パルスや DTMF など)の種類の識別子を設定します。
| DigitMode | INT | in | 桁モードを示します。 |
戻り値
このメソッドは、次のいずれかの値を返すことができます。
| リターン コード | 説明 |
|---|---|
| メソッドは成功しました。 | |
| 操作を実行するのに十分なメモリがありません。 | |
| 現在、コールが存在しません。 |
GenerateDigits メソッドは、現在のコールで桁を出力させます。
| pDigits | LPWSTR | in | 送信する桁の BSTR 表現へのポインター。 |
| DigitMode | INT | in | 桁モードを示します。 |
戻り値
このメソッドは、次のいずれかの値を返すことができます。
| リターン コード | 説明 |
|---|---|
| メソッドは成功しました。 | |
| 操作を実行するのに十分なメモリがありません。 | |
| 現在、コールが存在しません。 |
解説(Remarks)
アプリケーションは、pDigits パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにそのメモリを解放するために SysFreeString を使用する必要があります。
GetID メソッドは、現在のコールに関連付けられたデバイスの識別子を取得します。
| pDeviceClass | LPWSTR | in | TAPI デバイス クラスを表す BSTR へのポインター。 |
| pdwSize | DWORD* | out | デバイス識別子のバイト単位のサイズ。 |
| ppDeviceID | BYTE** | out | デバイス識別子。 |
戻り値
このメソッドは、次のいずれかの値を返すことができます。
| リターン コード | 説明 |
|---|---|
| メソッドは成功しました。 | |
| 操作を実行するのに十分なメモリがありません。 | |
| pdwSize または ppDeviceID パラメーターが有効なポインターではありません。 |
解説(Remarks)
アプリケーションは、このメソッドを呼び出す前に ITTAPI::RegisterCallNotifications を呼び出す必要があります。
アプリケーションは、pDeviceClass パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにそのメモリを解放するために SysFreeString を使用する必要があります。
アプリケーションは、ppDeviceID パラメーターに割り当てられたメモリを解放するために CoTaskMemFree 関数を呼び出す必要があります。
SetMediaType メソッドは、現在のコールの LINECALLINFO 構造体にメディア タイプを設定します。詳細については、lineSetMediaMode を参照してください。
| lMediaType | INT | in | メディア タイプのインジケーター。 |
戻り値
このメソッドは、次のいずれかの値を返すことができます。
| リターン コード | 説明 |
|---|---|
| メソッドは成功しました。 | |
| 関連付けられたコール オブジェクトが有効ではありません。 | |
| lMediaType パラメーターが有効ではありません。 | |
| 操作を実行するのに十分なメモリがありません。 |
MonitorMedia メソッドは、現在のコールで指定されたメディア タイプの監視を設定します。
| lMediaType | INT | in | メディア タイプのインジケーター。 |
戻り値
このメソッドは、次のいずれかの値を返すことができます。
| リターン コード | 説明 |
|---|---|
| メソッドは成功しました。 | |
| lMediaType パラメーターが有効ではありません。 | |
| 関連付けられたコール オブジェクトが有効ではありません。 | |
| 操作を実行するのに十分なメモリがありません。 |
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ITLegacyCallMediaControl "{D624582F-CC23-4436-B8A5-47C625C8045D}" #usecom global ITLegacyCallMediaControl IID_ITLegacyCallMediaControl "{}" #comfunc global ITLegacyCallMediaControl_DetectDigits 7 int #comfunc global ITLegacyCallMediaControl_GenerateDigits 8 wstr,int #comfunc global ITLegacyCallMediaControl_GetID 9 wstr,var,var #comfunc global ITLegacyCallMediaControl_SetMediaType 10 int #comfunc global ITLegacyCallMediaControl_MonitorMedia 11 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ITLegacyCallMediaControl "{D624582F-CC23-4436-B8A5-47C625C8045D}" #usecom global ITLegacyCallMediaControl IID_ITLegacyCallMediaControl "{}" #comfunc global ITLegacyCallMediaControl_DetectDigits 7 int #comfunc global ITLegacyCallMediaControl_GenerateDigits 8 wstr,int #comfunc global ITLegacyCallMediaControl_GetID 9 wstr,sptr,sptr #comfunc global ITLegacyCallMediaControl_SetMediaType 10 int #comfunc global ITLegacyCallMediaControl_MonitorMedia 11 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。