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 |