lineMonitorMedia 함수(tapi.h)

아티클
08/26/2023

lineMonitorMedia 함수는 지정된 호출에서 미디어 유형(모드)의 검색을 활성화하고 사용하지 않도록 설정합니다. 미디어 유형이 검색되면 메시지가 애플리케이션으로 전송됩니다. 자세한 내용은 ITLegacyCallMediaControl::MonitorMedia를 참조하세요.

구문

LONG lineMonitorMedia(
  HCALL hCall,
  DWORD dwMediaModes
);

매개 변수

hCall

호출에 대한 핸들입니다. hCall의 호출 상태는 유휴 상태를 제외한 모든 상태일 수 있습니다.

dwMediaModes

모니터링할 미디어 유형입니다. 이 매개 변수가 0이면 모든 미디어 형식 검색이 취소됩니다. 이 매개 변수는 하나 이상의 LINEMEDIAMODE_ 상수를 사용합니다.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

설명

lineOpen으로 지정된 미디어 유형은 적절한 애플리케이션에 새 수신 호출을 전달하기 위해 서비스 공급자가 이러한 미디어 유형을 검색할 수 있도록 하는 것과만 관련이 있습니다. 이전 lineMonitorMedia 호출로 인해 예상되는 미디어 모드 알림 메시지에는 영향을 주지 않습니다.

이 함수는 미디어 형식 모니터링이 종료된 시점이 아니라 미디어 유형 모니터링이 올바르게 시작된 경우 성공한 것으로 간주됩니다. 지정된 미디어 유형에 대한 미디어 모니터링은 dwMediaModes 매개 변수가 0으로 설정된 lineMonitorMedia를 호출하거나, 호출이 유휴 상태로 전환되거나, 애플리케이션이 호출에 대한 호출 핸들의 할당을 취소할 때까지 계속 적용됩니다. lineMonitorMedia 함수는 주로 이벤트 보고 메커니즘입니다. LINECALLINFO에 표시된 대로 호출의 미디어 유형(모드)은 서비스 공급자의 미디어 유형 검색의 영향을 받지 않습니다. 제어 애플리케이션만 통화의 미디어 유형을 변경할 수 있습니다.

서비스 공급자가 수행하는 기본 미디어 모니터링은 lineOpen에 지정된 모든 미디어 유형의 통합에 해당합니다.

이 함수는 모든 호출 상태에서 호출할 수 있지만 일반적으로 호출이 특정 호출 상태에 있는 동안에만 호출의 미디어 형식을 검색할 수 있습니다. 이러한 상태는 디바이스별로 다를 수 있습니다. 예를 들어 ISDN에서 메시지는 미디어 스트림이 존재하기 전에 미디어 스트림의 미디어 형식을 나타낼 수 있습니다. 마찬가지로 통화에 대한 고유한 벨소리 또는 호출된 식별자 정보를 사용하여 통화의 미디어 유형을 식별할 수 있습니다. 그렇지 않으면 서비스 공급자가 미디어 스트림을 필터링하여 통화의 미디어 유형을 확인할 수 있도록 통화에 응답해야 할 수 있습니다( 연결된 상태의 호출). 호출의 미디어 스트림 필터링은 계산 오버헤드를 의미하므로 애플리케이션은 필요하지 않은 경우 미디어 모니터링을 사용하지 않도록 설정해야 합니다. 호출의 미디어 유형이 호출을 처리해야 하는 애플리케이션을 선택하기 때문에 기본적으로 새로 들어오는 호출에 대해 미디어 모니터링이 사용하도록 설정됩니다.

음성 미디어 유형을 처리하는 발신 애플리케이션은 통화의 호출 끝에 있는 사람 또는 대상을 구분하기 위해 무음(톤)에 대한 호출을 모니터링할 수 있습니다. 예를 들어 집에 있는 사람은 짧은 "hello"로 통화에 응답할 수 있습니다. 사무실의 사용자는 이름과 회사 이름을 나타내는 더 긴 인사말을 제공할 수 있습니다. 응답 머신은 일반적으로 인사말이 더 길어질 수 있습니다.

lineMonitorMedia에서 사용하도록 설정된 미디어 모드 검색은 호출 미디어 스트림의 읽기 전용 작업으로 구현되므로 중단되지 않습니다.

전화 회의의 미디어 모니터링은 개별 참여 통화가 아닌 hConfCall 매개 변수에만 적용됩니다.