次の方法で共有


LINEMEDIACONTROLTONE 構造体 (tapi.h)

LINEMEDIACONTROLTONE 構造体は、トーンが検出されたときに実行されるメディア アクションを記述します。 配列内のエントリとして使用されます。 lineSetMediaControl 関数とTSPI_lineSetMediaControl関数では、この構造体を使用します。

構文

typedef struct linemediacontroltone_tag {
  DWORD dwAppSpecific;
  DWORD dwDuration;
  DWORD dwFrequency1;
  DWORD dwFrequency2;
  DWORD dwFrequency3;
  DWORD dwMediaControl;
} LINEMEDIACONTROLTONE, *LPLINEMEDIACONTROLTONE;

メンバー

dwAppSpecific

トーンのタグ付けにアプリケーションによって使用されます。 このトーンが検出されると、 dwAppSpecific メンバーの値がアプリケーションに返されます。

dwDuration

検出が行われる前にトーンが存在する時間 (ミリ秒単位)。

dwFrequency1

トーンの最初の周波数 (ヘルツ単位)。

dwFrequency2

トーンの 2 番目の周波数 (ヘルツ単位)。

dwFrequency3

トーンの 3 番目の周波数 (ヘルツ単位)。 トーンに必要な周波数が 3 つ未満の場合は、未使用の周波数に値 0 を使用する必要があります。 3 つの周波数がすべて 0 に設定されたトーンは無音と解釈され、無音検出に使用できます。

dwMediaControl

メディア コントロール アクション。 このメンバーは 、LINEMEDIACONTROL_定数のいずれかを使用します。

注釈

この構造体は拡張できません。

LINEMEDIACONTROLTONE 構造体は、タプル <トーンのメディアコントロール アクションを定義します>。 これらのタプルの配列が lineSetMediaControl 関数に渡され、特定の呼び出しに対するメディアの種類の変更によってトリガーされるメディア 制御アクションが設定されます。 リストされたメディア・タイプへの変更が検出されると、メディア・ストリームに対する対応するアクションが呼び出されます。

すべての周波数がゼロに設定されたトーンは無音に対応します。 そのため、アプリケーションは通話の情報ストリームで無音を監視できます。

要件

要件
Header tapi.h

こちらもご覧ください

TSPI_lineSetMediaControl

lineSetMediaControl