lineSetNumRings 함수(tapi.h)

아티클
03/05/2024

lineSetNumRings 함수는 들어오는 호출에 응답하기 전에 발생해야 하는 링 수를 설정합니다. 이 함수는 toll-saver-style 함수를 구현하는 데 사용할 수 있습니다. 여러 독립 애플리케이션에서 각 링 수를 등록할 수 있습니다. 함수 lineGetNumRings 는 요청된 최소 링 수를 반환합니다. 들어오는 호출에 응답하는 애플리케이션에서 통화에 응답하기 전에 대기해야 하는 링 수를 결정하는 데 사용할 수 있습니다.

구문

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

매개 변수

hLine

열린 줄 디바이스에 대한 핸들입니다.

dwAddressID

회선 디바이스의 주소입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

dwNumRings

모든 애플리케이션의 수신자 보호기 요청을 적용하기 위해 통화에 응답하기 전의 링 수입니다.

반환 값

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

설명

lineGetNumRings 및 lineSetNumRings 함수를 함께 사용하면 여러 독립 애플리케이션에서 유료 절약 기능의 구현을 지원하는 메커니즘을 제공합니다. lineSetNumRings를 호출하는 애플리케이션이 없는 경우 lineGetNumRings는 0xFFFFFFFF 반환합니다.

제품 상태의 호출 소유자이며 LINE_LINEDEVSTATE벨소리 메시지를 받은 애플리케이션은 모든 애플리케이션에서 수신자 보호기 설정을 적용하기 위해 호출에 응답하기 전에 lineGetNumRings에서 반환된 번호와 동일한 여러 링을 기다려야 합니다. 각 링 주기에 대해 별도의 LINE_LINEDEVSTATE 벨소리 메시지가 애플리케이션에 전송되므로 애플리케이션은 이러한 메시지를 계산해야 합니다. 응답하기 전에 이 호출의 연결이 끊어지고 그 직후에 다른 호출이 들어오면 LINE_CALLSTATE 메시지를 통해 애플리케이션에서 벨소리가 두 번째 호출과 관련이 있는지 확인할 수 있습니다.

알 수 없는 미디어 유형의 수신 전화에 응답하고 미디어 스트림을 필터링하여 TAPI에서 통화 분류를 수행하는 경우 TAPI는 이 번호도 적용합니다.

참고 이 작업은 순전히 정보이며 라인 디바이스의 호출 상태에 영향을 주지 않습니다.