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.

설명

이 함수는 톤 모니터링이 종료된 시점이 아니라 톤 모니터링이 올바르게 시작된 경우 성공합니다. 톤 모니터링은 다른 톤 목록(또는 NULL)으로 lineMonitorTones를 호출하여 명시적으로 비활성화되거나, 호출이 유휴 상태로 전환되거나, 애플리케이션이 호출에 대한 호출 핸들의 할당을 취소할 때까지 계속 적용됩니다.

이 함수는 모든 호출 상태에서 호출할 수 있지만 일반적으로 호출이 연결된 상태인 동안에만 톤을 검색할 수 있습니다. 톤 검색에는 일반적으로 계산 리소스가 필요합니다. 이러한 리소스에 대해 경쟁하는 서비스 공급자 및 기타 활동에 따라 검색할 수 있는 톤 수는 시간에 따라 달라질 수 있습니다. 또한 단일 3중 주파수 톤과 3개의 단일 빈도 톤을 모니터링하는 데 동일한 양의 리소스를 사용할 수 있습니다. 리소스가 과도하게 커밋되면 LINEERR_RESOURCEUNAVAIL 오류가 반환됩니다.

lineMonitorTones 함수는 침묵을 감지하는 데도 사용됩니다. 무음은 빈도가 0인 톤으로 지정됩니다.

전화 회의의 톤 모니터링은 개별 참여 통화가 아닌 hConfCall에만 적용됩니다.

LINEERR_INVALPOINTER 오류 값이 반환되면 지정된 lpToneList 매개 변수가 잘못되었거나 dwNumEntries 매개 변수로 지정된 값이 너무 큽니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi.h
라이브러리 Tapi32.lib
DLL Tapi32.dll

추가 정보

LINEMONITORTONE

보조 회선 서비스 함수

TAPI 2.2 참조 개요