Win32 API 日本語リファレンス
ホーム › Devices.Tapi › ITLegacyCallMediaControl2

ITLegacyCallMediaControl2

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID57ca332d-7bc2-44f1-a60c-936fe8d7ce73継承元ITLegacyCallMediaControl呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl12

メソッド 10

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

vtbl 12 HRESULT GenerateDigits2(LPWSTR pDigits, INT DigitMode, INT lDuration)
pDigitsLPWSTRin生成(送出)するダイヤル数字の文字列。
DigitModeINTin生成する数字のモード(DTMF/パルス等)を示す値。
lDurationINTin各数字の送出時間(ミリ秒)。0で既定値。
vtbl 13 HRESULT GatherDigits(INT DigitMode, INT lNumDigits, LPWSTR pTerminationDigits, INT lFirstDigitTimeout, INT lInterDigitTimeout)
DigitModeINTin収集する数字のモード(DTMF/パルス等)を示す値。
lNumDigitsINTin収集する数字の最大個数。
pTerminationDigitsLPWSTRin収集を終了させる終端数字の文字列。
lFirstDigitTimeoutINTin最初の数字を待つタイムアウト時間(ミリ秒)。
lInterDigitTimeoutINTin数字間の待機タイムアウト時間(ミリ秒)。
vtbl 14 HRESULT DetectTones(TAPI_DETECTTONE* pToneList, INT lNumTones)
pToneListTAPI_DETECTTONE*in検出対象トーンを記述するTAPI_DETECTTONE構造体配列へのポインター。
lNumTonesINTinpToneList配列に含まれるトーン定義の個数。
vtbl 15 HRESULT DetectTonesByCollection(ITCollection2* pDetectToneCollection)
pDetectToneCollectionITCollection2*in検出対象トーンのITDetectToneを保持するITCollection2コレクション。
vtbl 16 HRESULT GenerateTone(TAPI_TONEMODE ToneMode, INT lDuration)
ToneModeTAPI_TONEMODEin生成するトーンの種別を示すTAPI_TONEMODE列挙値。
lDurationINTinトーン生成時間(ミリ秒)。0で既定値。
vtbl 17 HRESULT GenerateCustomTones(TAPI_CUSTOMTONE* pToneList, INT lNumTones, INT lDuration)
pToneListTAPI_CUSTOMTONE*in生成するカスタムトーンを記述するTAPI_CUSTOMTONE構造体配列へのポインター。
lNumTonesINTinpToneList配列に含まれるトーン定義の個数。
lDurationINTinトーン全体の生成時間(ミリ秒)。
vtbl 18 HRESULT GenerateCustomTonesByCollection(ITCollection2* pCustomToneCollection, INT lDuration)
pCustomToneCollectionITCollection2*in生成するカスタムトーンのITCustomToneを保持するITCollection2コレクション。
lDurationINTinトーン全体の生成時間(ミリ秒)。
vtbl 19 HRESULT CreateDetectToneObject(ITDetectTone** ppDetectTone)
ppDetectToneITDetectTone**out新規作成された検出トーン設定用ITDetectToneを受け取る出力先。
vtbl 20 HRESULT CreateCustomToneObject(ITCustomTone** ppCustomTone)
ppCustomToneITCustomTone**out新規作成されたカスタムトーン設定用ITCustomToneを受け取る出力先。
vtbl 21 HRESULT GetIDAsVariant(LPWSTR bstrDeviceClass, VARIANT* pVarDeviceID)
bstrDeviceClassLPWSTRinIDを取得する対象のデバイスクラス名文字列。
pVarDeviceIDVARIANT*outデバイスIDをバイト配列VARIANTとして受け取る出力先。

HSP用 COM定義

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

出力引数: 
#define global IID_ITLegacyCallMediaControl2 "{57CA332D-7BC2-44F1-A60C-936FE8D7CE73}"
#usecom global ITLegacyCallMediaControl2 IID_ITLegacyCallMediaControl2 "{}"
#comfunc global ITLegacyCallMediaControl2_GenerateDigits2                  12 wstr,int,int
#comfunc global ITLegacyCallMediaControl2_GatherDigits                     13 int,int,wstr,int,int
#comfunc global ITLegacyCallMediaControl2_DetectTones                      14 var,int
#comfunc global ITLegacyCallMediaControl2_DetectTonesByCollection          15 sptr
#comfunc global ITLegacyCallMediaControl2_GenerateTone                     16 int,int
#comfunc global ITLegacyCallMediaControl2_GenerateCustomTones              17 var,int,int
#comfunc global ITLegacyCallMediaControl2_GenerateCustomTonesByCollection  18 sptr,int
#comfunc global ITLegacyCallMediaControl2_CreateDetectToneObject           19 sptr
#comfunc global ITLegacyCallMediaControl2_CreateCustomToneObject           20 sptr
#comfunc global ITLegacyCallMediaControl2_GetIDAsVariant                   21 wstr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。