ITLegacyCallMediaControl2::D etectTonesByCollection メソッド (tapi3if.h)

DetectTonesByCollection メソッドは、呼び出しのインバンド トーンの検出を有効または無効にします。 指定したトーンが検出されるたびに、メッセージがアプリケーションに送信されます。

このメソッドは、Visual Basic およびスクリプト アプリケーションを対象としています。 C/C++ アプリケーションでは、代わりに DetectTones メソッドを使用する 必要があります。

構文

HRESULT DetectTonesByCollection(
  [in] ITCollection2 *pDetectToneCollection
);

パラメーター

[in] pDetectToneCollection

監視するトーンを表す ITDetectTone インターフェイス ポインターのコレクションを含む ITCollection2 インターフェイスへのポインター。 リスト内の各トーンには、 TE_TONEEVENT イベントによってトーン検出が報告されたときに個々のトーンを識別するために使用されるアプリケーション定義のタグ フィールドがあります。 詳細については、「解説」を参照してください。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドが成功しました。
E_POINTER	pDetectToneCollection パラメーターが有効なポインターではありません。
E_OUTOFMEMORY	トーン バッファーを割り当てるのに十分なメモリがありません。
TAPI_E_INVALCALLSTATE	呼び出しは 接続 状態である必要があります。

注釈

このメソッドは TAPI 2 に変換されます。xlineMonitorTones 呼び出し。

進行中のトーン監視をキャンセルするには、 DetectTonesByCollection メソッドを呼び出し、空のコレクションを指定します。 監視するトーンの一覧を変更するには、このメソッドを呼び出し、新しいトーン コレクションを指定します。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	tapi3if.h
Library	Uuid.lib
[DLL]	Tapi3.dll

こちらもご覧ください

ITCollection2

ITDetectTone

ITLegacyCallMediaControl2