TSPI_lineMonitorMedia 함수(tspi.h)

아티클
03/13/2024

TSPI_lineMonitorMedia 함수는 지정된 호출에서 미디어 유형 검색을 사용하도록 설정하고 사용하지 않도록 설정합니다. 미디어 유형이 검색되면 LINE_MONITORMEDIA 메시지가 TAPI로 전송됩니다.

구문

LONG TSPIAPI TSPI_lineMonitorMedia(
  HDRVCALL hdCall,
  DWORD    dwMediaModes
);

매개 변수

hdCall

미디어 모니터링을 설정할 호출에 대한 핸들입니다. hdCall의 호출 상태는 유휴 상태를 제외한 모든 상태일 수 있습니다.

dwMediaModes

모니터링할 미디어 유형입니다. dwMediaModes 매개 변수에는 LINEMEDIAMODE_ 상수 중 하나가 있을 수 있습니다.

값이 0이면 모든 미디어 유형 모니터링이 취소됩니다.

반환 값

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

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

설명

모니터링할 미디어 유형 목록에 잘못된 정보가 포함된 경우 서비스 공급자는 LINEERR_INVALMEDIAMODE 반환합니다.

이 함수는 미디어 형식 모니터링이 종료된 시점이 아니라 미디어 형식 모니터링이 올바르게 시작된 경우 0(성공)을 반환합니다. 미디어 형식이 0으로 설정된 dwMediaModes 매개 변수를 사용하여 TSPI_lineMonitorMedia 호출하거나 호출이 유휴 상태로 전환될 때까지 지정된 미디어 형식에 대한 미디어 모니터링이 명시적으로 비활성화될 때까지 계속 적용됩니다.

TSPI_lineMonitorMedia 주로 이벤트 보고 메커니즘입니다. LINECALLINFO에 표시된 대로 호출의 미디어 유형은 서비스 공급자의 미디어 유형 검색의 영향을 받지 않습니다. TAPI 또는 클라이언트 애플리케이션만 TSPI_lineSetMediaMode 사용하여 통화의 표시된 미디어 유형을 변경할 수 있습니다. 특정 미디어 형식의 실제 사용은 별도의 미디어 스트림 API(예: Comm 또는 WAVE)를 통해 발생합니다.

서비스 공급자가 새 호출 모양을 위해 수행하는 기본 미디어 모니터링은 TSPI_lineSetDefaultMediaDetection 지정된 모든 미디어 형식의 통합에 해당합니다. 새 호출이 설정된 직후 TAPI는 일반적으로 TSPI_lineMonitorMedia 호출하여 호출의 클라이언트 애플리케이션에서 원하는 모든 미디어 형식의 통합에 대해 검색되고 보고된 미디어 형식 집합을 줄입니다.

서비스 공급자는 통화가 유휴 상태가 되면 미디어 모니터링을 취소해야 합니다. TAPI는 모든 클라이언트가 원하는 미디어 형식의 결합을 계산하고 결과를 이 함수에 전달해야 합니다. 서비스 공급자는 TAPI에 의해 이 함수에 전달된 집합을 사용합니다.

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

TSPI_lineMonitorMedia 사용하도록 설정된 미디어 모드 검색은 통화 미디어 스트림의 읽기 전용 작업으로 구현되므로 중단되지 않습니다. TSPI_lineMonitorMedia 설정의 결과로 선에 신호가 전송되지 않습니다.

전달된 미디어 유형과 관련하여 TAPI는 예약 비트 집합이 없음을 보장합니다. 서비스 공급자는 미디어 유형이 실제로 서비스 공급자가 지원하는지 여부를 확인하는 등 미디어 유형에 대한 추가 유효성 검사를 수행해야 합니다.