phoneGetRing 함수(tapi.h)

phoneGetRing 함수를 사용하면 애플리케이션이 현재 링 모드로 지정된 열린 휴대폰 디바이스를 쿼리할 수 있습니다.

구문

LONG phoneGetRing(
  HPHONE  hPhone,
  LPDWORD lpdwRingMode,
  LPDWORD lpdwVolume
);

매개 변수

hPhone

열려 있는 휴대폰 디바이스에 대한 핸들입니다.

lpdwRingMode

휴대폰이 울리는 벨소리 패턴입니다. 0은 휴대폰이 울리지 않음을 나타냅니다.

lpdwVolume

휴대폰이 울리는 볼륨 수준입니다. 이는 0x0000FFFF(최대 볼륨)에 0x00000000(무음) 범위의 숫자입니다. 이 범위의 볼륨 설정의 실제 세분성 및 정량화는 서비스 공급자별로 다릅니다.

반환 값

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

설명

서비스 공급자는 각 휴대폰의 링 모드에 해당하는 실제 가청 벨소리 패턴을 정의합니다.

요구 사항

추가 정보

보조 전화 서비스 기능

TAPI 2.2 참조 개요