PHONE_STATE 메시지

TAPI는 휴대폰 디바이스의 상태 변경되는 때마다 애플리케이션에 PHONE_STATE 메시지를 보냅니다.

매개 변수

hPhone

휴대폰 디바이스에 대한 핸들입니다.

dwCallbackInstance

휴대폰 디바이스를 열 때 애플리케이션의 콜백 instance 제공됩니다.

dwParam1

변경된 전화 상태입니다. 이 매개 변수는 PHONESTATE_ 상수 중 하나를 사용합니다.

dwParam2

상태 변경을 자세히 설명하는 전화 상태 종속 정보입니다. 여러 상태 항목이 변경되었으므로 dwParam1에서 여러 플래그가 설정된 경우에는 이 매개 변수가 사용되지 않습니다. 애플리케이션은 전체 정보 집합을 얻기 위해 phoneGetStatus 를 호출해야 합니다.

dwParam1이 PHONESTATE_OWNER 경우 dwParam2에는 새 소유자 수가 포함됩니다.

dwParam1이 PHONESTATE_MONITORS 경우 dwParam2에는 새 모니터 수가 포함됩니다.

dwParam1이 PHONESTATE_LAMP 경우 dwParam2에는 변경된 램프의 단추/램프 식별자가 포함됩니다.

dwParam1이 PHONESTATE_RINGMODE 경우 dwParam2에는 새 링 모드가 포함됩니다.

dwParam1이 PHONESTATE_HANDSET 스피커 또는 헤드셋인 경우 dwParam2에는 해당 후크위치 디바이스의 새 후크위치 모드가 포함됩니다. 이 매개 변수는 PHONEHOOKSWITCHMODE_ 상수 중 하나를 사용합니다.

dwParam3

사용되지 않습니다.

반환 값

반환 값이 없습니다.

설명

phoneSetStatusMessages 및 phoneGetStatusMessages를 사용하여 애플리케이션에 PHONE_STATE 메시지를 보내고 제어하고 쿼리할 수 있습니다. 기본적으로 이 메시지는 사용하지 않도록 설정할 수 없는 PHONESTATE_REINIT 제외한 모든 상태 변경에 대해 사용하지 않도록 설정됩니다. 이 메시지는 PHONEPRIVILEGE_OWNER 또는 PHONEPRIVILEGE_MONITOR 설정된 dwPrivileges 매개 변수로 phoneOpen을 호출하는 애플리케이션을 포함하여 휴대폰에 대한 핸들이 있는 모든 애플리케이션으로 전송됩니다.

소유자 및/또는 모니터 표시가 있는 PHONE_STATE 메시지가 이미 휴대폰에 대한 핸들이 있는 애플리케이션으로 전송됩니다. 이는 phoneOpen, phoneClose 또는 phoneShutdown을 사용하여 휴대폰 디바이스의 소유권 또는 모니터링을 변경하는 다른 애플리케이션의 결과일 수 있습니다.

요구 사항

요구 사항	값
TAPI 버전	TAPI 2.0 이상이 필요합니다.
헤더	Tapi.h

추가 정보

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown