lineGetNumRings 함수(tapi.h)

아티클
07/16/2024

lineGetNumRings 함수는 호출에 응답하기 전에 지정된 주소에서 들어오는 호출이 울릴 링 수를 결정합니다.

통사론

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

매개 변수

hLine

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

dwAddressID

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

lpdwNumRings

모든 현재 lineSetNumRings 요청의 최소값인 링 수입니다.

반환 값

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

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

발언

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

상태 및 LINE_LINEDEVSTATE울리는 메시지를 제공하는 호출에 대한 핸들을 수신하는 애플리케이션은 lineGetNumRings 반환된 번호와 동일한 여러 링을 기다린 후 모든 애플리케이션에서 수신자 보호기 설정을 준수하기 위해 호출에 응답해야 합니다. lineGetNumRings 함수는 lineSetNumRings지정된 모든 애플리케이션의 링 수 중 최소값을 반환합니다. 이 숫자는 동적으로 달라질 수 있으므로 애플리케이션은 호출에 응답할 수 있는 옵션이 lineGetNumRings를 호출해야 합니다. lineSetNumRings호출한 애플리케이션이 없는 경우 반환되는 링 수는 0xFFFFFFFF. 각 링 주기에 대해 별도의 LINE_LINEDEVSTATE 벨소리 메시지가 애플리케이션에 전송됩니다.

TAPI에서 알 수 없는 미디어 모드의 모든 호출에 응답하고 미디어 스트림을 필터링하는 호출 분류를 수행하는 경우 TAPI는 이 번호도 적용합니다.

참고 이 작업은 순전히 정보 제공이며 그 자체로는 회선 디바이스의 호출 상태에 영향을 주지 않습니다.