phoneSetVolume 함수(tapi.h)
phoneSetVolume 함수는 지정된 후크위치 디바이스의 스피커 구성 요소 볼륨을 지정된 수준으로 설정합니다.
구문
LONG phoneSetVolume(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
매개 변수
hPhone
열려 있는 휴대폰 디바이스에 대한 핸들입니다. 애플리케이션은 휴대폰의 소유자여야 합니다.
dwHookSwitchDev
화자의 볼륨을 설정할 후크위치 디바이스( PHONEHOOKSWITCHDEV_ 상수 중 하나).
dwVolume
디바이스의 새 볼륨 설정입니다. dwVolume 매개 변수는 hookswitch 디바이스의 볼륨 수준을 지정합니다. 이는 0x0000FFFF(최대 볼륨)에 0x00000000(무음) 범위의 숫자입니다. 이 범위의 볼륨 설정의 실제 세분성 및 정량화는 서비스 공급자별로 다릅니다. 범위를 벗어난 dwVolume 의 값은 범위에서 가장 가까운 값으로 설정됩니다.
반환 값
함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 PHONE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tapi.h |
| 라이브러리 | Tapi32.lib |
| DLL | Tapi32.dll |