phoneGetGain 함수(tapi.h)
phoneGetGain 함수는 지정된 휴대폰 후크위치 디바이스의 마이크 게인 설정을 반환합니다.
구문
LONG phoneGetGain(
HPHONE hPhone,
DWORD dwHookSwitchDev,
LPDWORD lpdwGain
);
매개 변수
hPhone
열려 있는 휴대폰 디바이스에 대한 핸들입니다.
dwHookSwitchDev
게인 수준을 쿼리하는 후크위치 디바이스입니다. dwHookSwitchDev 매개 변수는 하나의 비트 집합만 가질 수 있습니다. 이 매개 변수는 PHONEHOOKSWITCHDEV_ 상수 중 하나만 사용합니다.
lpdwGain
후크위치 마이크 구성 요소의 현재 게인 설정을 포함하는 DWORD 에 대한 포인터입니다. dwGain 매개 변수는 hookswitch 디바이스의 볼륨 수준을 지정합니다. 0x0000FFFF(최대 볼륨)에 대한 범위 0x00000000(무음)의 숫자입니다. 이 범위의 게인 설정의 실제 세분성 및 수량화는 서비스 공급자에 따라 다릅니다.
반환 값
요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tapi.h |
| 라이브러리 | Tapi32.lib |
| DLL | Tapi32.dll |