lineMonitorTones 関数 (tapi.h)

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

構文

LONG lineMonitorTones(
  HCALL                   hCall,
  LPLINEMONITORTONE const lpToneList,
  DWORD                   dwNumEntries
);

パラメーター

hCall

音声チャネル のトーンを監視する通話を処理します。 hCall の呼び出し状態は、アイドル状態を除く任意の状態にすることができます。

lpToneList

監視するトーンの一覧。 このパラメーターは LINEMONITORTONE 型です。 このリストの各トーンには、トーン検出を報告するためにリスト内の個々のトーンを識別するために使用されるアプリケーション定義のタグ フィールドがあります。 進行中のトーン監視は、lpToneList の場合は NULL、または別のトーン リストを使用してこの操作を呼び出すことによってキャンセルまたは変更されます。

dwNumEntries

lpToneList 内のエントリの数。 lpToneList が NULL の場合、このパラメーターは無視されます。

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。

LINEERR_INVALCALLHANDLE、LINEERR_INVALCALLSTATE、LINEERR_INVALPOINTER、LINEERR_INVALTONE、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。

注釈

トーン監視が終了したときではなく、トーン監視が正しく開始された場合、この関数は成功します。 トーン監視は、 lineMonitorTones を別のトーン リスト (または NULL) で呼び出すことによって明示的に無効にされるまで、呼び出しが アイドル状態に移行するまで、またはアプリケーションが呼び出しの呼び出しハンドルの割り当てを解除するまで有効なままです。

この関数は任意の呼び出し状態で呼び出すことができますが、トーンは通常、呼び出しが 接続 状態の間にのみ検出できます。 トーン検出には通常、計算リソースが必要です。 このようなリソースを競合するサービス プロバイダーやその他のアクティビティによっては、検出できるトーンの数が時間の経過と同時に異なる場合があります。 また、1 つの 3 つの周波数トーンと 3 つの単一周波数トーンを監視するために、同等の量のリソースを使用できます。 リソースがオーバーコミットされると、LINEERR_RESOURCEUNAVAIL エラーが返されます。

lineMonitorTones 関数は、無音を検出するためにも使用されます。 無音は、周波数が 0 のトーンとして指定されます。

電話会議でのトーンの監視は hConfCall にのみ適用され、参加している個々の通話には適用されません

LINEERR_INVALPOINTERエラー値が返された場合、指定された lpToneList パラメーターが無効であるか、 dwNumEntries パラメーターで指定された値が大きすぎます。

要件

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

こちらもご覧ください

LINEMONITORTONE

補助回線サービス関数

TAPI 2.2 リファレンスの概要