TSPI_lineMonitorDigits 함수(tspi.h)

아티클
08/26/2023

TSPI_lineMonitorDigits 함수는 호출에서 수신된 숫자의 버퍼되지 않은 검색을 사용하거나 사용하지 않도록 설정합니다. 지정된 숫자 모드의 숫자가 검색될 때마다 TAPI를 통해 애플리케이션에 LINE_MONITORDIGITS 메시지가 전송되어 검색되는 숫자를 나타냅니다.

구문

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 자발적으로 호출하지 않습니다.

이 함수는 모든 호출 상태에서 호출할 수 있지만 일반적으로 호출이 연결된 상태인 동안에만 숫자가 검색됩니다.

숫자가 검색될 때마다 서비스 공급자는 LINE_MONITORDIGITS 메시지를 TAPI로 보내고 검색된 숫자를 매개 변수로 전달합니다. dwDigitModes에서 LINEDIGITMODE_DTMF 및 LINEDIGITMODE_DTMFEND 모두 설정된 경우 두 LINE_MONITORDIGITS 메시지가 각 자릿수에 대해 전송됩니다.

TAPI는 TSPI_lineMonitorDigits 사용하여 버퍼되지 않은 숫자 검색을 사용하거나 사용하지 않도록 설정할 수 있습니다. 버퍼링된 숫자 검색에 TSPI_lineGatherDigits 사용할 수 있습니다. 버퍼링된 숫자 수집이 완료되면 LINE_GATHERDIGITS 메시지가 전송됩니다. 버퍼링된 숫자와 버퍼링되지 않은 숫자 검색은 동일한 호출에서 동시에 사용하도록 설정할 수 있습니다.