phoneSetRing 함수(tapi.h)

아티클
03/05/2024

phoneSetRing 함수는 지정된 링 모드 및 볼륨을 사용하여 지정된 열린 휴대폰 디바이스를 울립니다.

구문

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

매개 변수

hPhone

열려 있는 휴대폰 디바이스에 대한 핸들입니다. 애플리케이션은 휴대폰 디바이스의 소유자여야 합니다.

dwRingMode

전화를 울릴 링 패턴입니다. 이 매개 변수는 PHONECAPS 구조체의 dwNumRingModes 멤버 값까지 0 범위 내에 있어야 합니다. dwNumRingModes가 0이면 휴대폰의 링 모드를 제어할 수 없습니다. dwNumRingModes가 1이면 dwRingMode의 값이 0이면 휴대폰이 실행되지 않아야 하며(무음) 1부터 dwNumRingModes까지의 다른 값은 휴대폰 디바이스에 유효한 링 모드입니다.

dwVolume

휴대폰이 울리는 볼륨 수준입니다. 이는 0x0000FFFF(최대 볼륨)에 0x00000000(무음) 범위의 숫자입니다. 이 범위의 볼륨 설정의 실제 세분성 및 정량화는 서비스 공급자별로 다릅니다. 범위를 벗어난 dwVolume 의 값은 범위에서 가장 가까운 값으로 설정됩니다.

반환 값

함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 PHONE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALRINGMODE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.