TSPI_lineMonitorDigits関数 (tspi.h)

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

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

構文

LONG TSPIAPI TSPI_lineMonitorDigits(
  HDRVCALL hdCall,
  DWORD    dwDigitModes
);

パラメーター

hdCall

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

dwDigitModes

監視するディジットモード。値が 0 の dwDigitModes パラメーターは、桁の監視を取り消します。 dwDigitModes パラメーターには、LINEDIGITMODE_定数のいずれかを指定できます。

戻り値

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

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

注釈

この関数は、数字の監視が終了したときではなく、桁の監視が正しく開始されると 0 (成功) を返します。桁の監視は、dwDigitModes が 0 に設定されたTSPI_lineMonitorDigitsの呼び出しによって明示的に無効になるか、呼び出しがアイドル状態に遷移するまで有効です。この関数は、桁の監視が取り消された場合 (つまり、 dwDigitModes パラメーターが 0 の場合) に 0 を返す必要があります。サービスプロバイダーは、呼び出しがアイドル状態になったときに、桁の監視を終了する必要があります。 TAPI は、監視を終了するために TSPI_lineMonitorDigits を自発的に呼び出しません。

この関数は任意の呼び出し状態で呼び出すことができますが、通常、数字は呼び出しが接続状態の間にのみ検出されます。

数字が検出されるたびに、サービスプロバイダーは TAPI にLINE_MONITORDIGITS メッセージを送信し、検出された数字をパラメーターとして渡します。 dwDigitModes でLINEDIGITMODE_DTMFとLINEDIGITMODE_DTMFENDの両方が設定されている場合、2 つのLINE_MONITORDIGITS メッセージが数字ごとに送信されます。

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