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 |