ITLegacyCallMediaControl2::D etectTonesByCollection メソッド (tapi3if.h)
DetectTonesByCollection メソッドは、呼び出しのインバンド トーンの検出を有効または無効にします。 指定したトーンが検出されるたびに、メッセージがアプリケーションに送信されます。
このメソッドは、Visual Basic およびスクリプト アプリケーションを対象としています。 C/C++ アプリケーションでは、代わりに DetectTones メソッドを使用する 必要があります。
構文
HRESULT DetectTonesByCollection(
[in] ITCollection2 *pDetectToneCollection
);
パラメーター
[in] pDetectToneCollection
監視するトーンを表す ITDetectTone インターフェイス ポインターのコレクションを含む ITCollection2 インターフェイスへのポインター。 リスト内の各トーンには、 TE_TONEEVENT イベントによってトーン検出が報告されたときに個々のトーンを識別するために使用されるアプリケーション定義のタグ フィールドがあります。 詳細については、「解説」を参照してください。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
|
pDetectToneCollection パラメーターが有効なポインターではありません。 |
|
トーン バッファーを割り当てるのに十分なメモリがありません。 |
|
呼び出しは 接続 状態である必要があります。 |
注釈
このメソッドは TAPI 2 に変換されます。xlineMonitorTones 呼び出し。
進行中のトーン監視をキャンセルするには、 DetectTonesByCollection メソッドを呼び出し、空のコレクションを指定します。 監視するトーンの一覧を変更するには、このメソッドを呼び出し、新しいトーン コレクションを指定します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | tapi3if.h |
Library | Uuid.lib |
[DLL] | Tapi3.dll |