phoneSetHookSwitch 함수(tapi.h)

아티클
2023. 08. 26.

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

추가 정보

다음을 통해 공유