lineMonitorDigits 関数 (tapi.h)

[アーティクル]
08/26/2023

lineMonitorDigits 関数は、呼び出しで受信した数字のバッファーなしの検出を有効または無効にします。指定した数字モードの数字が検出されるたびに、検出された数字を示すメッセージがアプリケーションに送信されます。

構文

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

パラメーター

hCall

数字を検出する呼び出しを処理します。 hCall の呼び出し状態は、アイドル状態または切断状態を除く任意の状態にすることができます。

dwDigitModes

監視するディジットモードまたはモード。 dwDigitModes が 0 の場合、桁の監視は取り消されます。このパラメーターは、1 つ以上の LINEDIGITMODE_定数を使用します。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALDIGITMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注釈

この関数は、桁の監視が終了したときではなく、桁の監視が正しく開始された場合に成功したと見なされます。 dwDigitModes を 0 に設定して lineMonitorDigits を呼び出し、呼び出しがアイドル状態に移行するまで、またはアプリケーションが呼び出しの呼び出しハンドルの割り当てを解除するまで、数字の監視は有効です。この関数は任意の呼び出し状態で呼び出すことができますが、通常、数字は呼び出しが接続状態の間にのみ検出されます。

数字が検出されるたびに、検出された数字をパラメーターとして渡すLINE_MONITORDIGITS メッセージがアプリケーションに送信されます。

アプリケーションでは 、lineMonitorDigits を使用して、バッファーなしのディジット検出を有効または無効にすることができます。バッファー内のディジット検出には lineGatherDigits を使用できます。バッファーされた桁の収集が完了すると、 LINE_GATHERDIGITS メッセージがアプリケーションに送信されます。同じ呼び出しで、バッファー内のディジット検出とバッファーなしディジット検出の両方を同時に有効にすることができます。

電話会議の数字の監視は、個々の参加している通話には適用されず、 hConfCall にのみ適用されます。