次の方法で共有

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

  • [アーティクル]

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

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

構文

HRESULT DetectTones(
  [in] TAPI_DETECTTONE *pToneList,
  [in] long            lNumTones
);

パラメーター

[in] pToneList

検出するトーンを指定する TAPI_DETECTTONE 配列へのポインター。 配列内の各トーンには 、TE_TONEEVENT型 のトーン検出イベントが報告されたときに、リスト内の個々のトーンを識別するために使用されるアプリケーション定義のタグ フィールドがあります。 詳細については、「解説」を参照してください。

[in] lNumTones

pToneList パラメーターで指定された配列内のエントリの数。 pToneList が NULL の場合、このパラメーターは無視されます。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
E_POINTER
 pToneList パラメーターが有効なポインターではありません。
TAPI_E_INVALCALLSTATE
 呼び出しは 接続 状態である必要があります。

注釈

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

進行中のトーン監視をキャンセルするには、 DetectTones メソッドを呼び出し、 NULLpToneList パラメーターを指定します。 監視するトーンの一覧を変更するには、このメソッドを呼び出し、新しいトーン リストを指定します。

要件

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

こちらもご覧ください

ITLegacyCallMediaControl2

TAPI_DETECTTONE