다음을 통해 공유

TSPI_lineSetDefaultMediaDetection 함수(tspi.h)

  • 아티클

TSPI_lineSetDefaultMediaDetection 프로시저는 표시된 줄에 대해 검색할 새로운 미디어 유형 집합을 서비스 공급자에게 알려줍니다(이전 집합 대체). 또한 이 줄의 후속 호출(인바운드 또는 아웃바운드)에서 모니터링해야 하는 미디어 유형의 초기 집합을 설정합니다.

구문

LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
  HDRVLINE hdLine,
  DWORD    dwMediaModes
);

매개 변수

hdLine

미디어 모니터링을 설정할 줄에 대한 핸들입니다.

dwMediaModes

TAPI에 관심 있는 미디어 유형입니다. 이 매개 변수는 LINEMEDIAMODE_ 상수 중 하나를 사용합니다.

반환 값

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL.

설명

TAPI는 일반적으로 이 함수를 호출하여 줄에 대해 검색된 미디어 유형 집합을 TAPI 수준에서 선이 열리거나 닫을 때마다 모든 미해결 선에서 선택한 모든 모드의 합합으로 업데이트합니다. 미디어 검색이 거부되면 lineOpen 호출 시도가 거부됩니다. 이 프로시저에 대한 단일 호출은 일반적으로 디바이스 식별자 LINEMAPPER를 지정하지 않는 lineOpen 호출의 결과입니다. 디바이스 식별자 LINEMAPPER는 TSPI 수준에서 사용되지 않습니다.

TAPI는 모든 클라이언트가 원하는 미디어 형식의 합을 계산하고 결과를 이 함수에 전달해야 합니다. 서비스 공급자는 TAPI에 의해 이 함수에 전달된 집합을 사용합니다. TAPI는 dwMediaModes 매개 변수에 하나 이상의 비트 집합이 있고 예약된 비트가 설정되지 않았는지 확인합니다. 서비스 공급자는 미디어 유형이 실제로 서비스 공급자에서 지원되는지 여부를 확인하는 등 미디어 유형에 대한 추가 유효성 검사를 수행해야 합니다. 선이 열려 있는 애플리케이션이 모두 모니터이거나 들어오는 호출 처리에 관심이 없는 경우 모든 미디어 형식의 합합은 값 0일 수 있습니다.

TAPI 수준에는 직접 해당하는 함수가 없습니다. 이 프로시저는 LINEMAPPER 이외의 특정 디바이스 식별자를 사용하여 호출될 때 lineOpen 프로시저에 의해 특정 줄에 내포된 "요청 미디어 유형"에 해당합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tspi.h

추가 정보

LINECALLPARAMS

LINEMEDIAMODE_ 상수

TSPI_lineClose