phoneSetHookSwitch 함수(tapi.h)
phoneSetHookSwitch 함수는 지정된 열린 휴대폰의 후크위치 디바이스의 후크 상태를 지정된 모드로 설정합니다. 나열된 후크위치 디바이스의 hookswitch 상태만 영향을 받습니다.
구문
LONG phoneSetHookSwitch(
HPHONE hPhone,
DWORD dwHookSwitchDevs,
DWORD dwHookSwitchMode
);
매개 변수
hPhone
열려 있는 휴대폰 디바이스에 대한 핸들입니다. 애플리케이션은 휴대폰의 소유자여야 합니다.
dwHookSwitchDevs
후크위치 모드를 설정할 디바이스입니다. 이 매개 변수는 PHONEHOOKSWITCHDEV_ 상수 중 하나만 사용합니다.
PHONEHOOKSWITCHDEV_HANDSET
휴대폰의 핸드셋입니다.
PHONEHOOKSWITCHDEV_SPEAKER
휴대폰의 스피커폰 또는 외래입니다.
PHONEHOOKSWITCHDEV_HEADSET
휴대폰의 헤드셋.
dwHookSwitchMode
설정할 후크위치 모드입니다. 이 매개 변수는 PHONEHOOKSWITCHMODE_ 상수 중 하나만 사용합니다.
PHONEHOOKSWITCHMODE_ONHOOK
장치의 마이크와 스피커는 모두 온후크입니다.
PHONEHOOKSWITCHMODE_MIC
장치의 마이크가 활성 상태이고 스피커가 음소거되어 있습니다.
PHONEHOOKSWITCHMODE_SPEAKER
장치의 스피커가 활성 상태이고 마이크가 음소거되어 있습니다.
PHONEHOOKSWITCHMODE_MICSPEAKER
장치의 마이크와 스피커가 모두 활성화되어 있습니다.
반환 값
함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하거나 오류가 발생할 경우 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 PHONE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED.
설명
후크위치 모드는 지정된 모든 디바이스에서 동일합니다. 다른 설정이 필요한 경우 다른 매개 변수 집합을 사용하여 이 함수를 여러 번 호출할 수 있습니다. 후크위치 상태가 변경된 후 PHONE_STATE 메시지가 애플리케이션으로 전송됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tapi.h |
| 라이브러리 | Tapi32.lib |
| DLL | Tapi32.dll |