phoneSetHookSwitch 함수(tapi.h)

아티클
08/26/2023

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

추가 정보