PHONE_STATE訊息

TAPI 會在手機裝置的狀態變更時,將 PHONE_STATE 訊息傳送至應用程式。

            

參數

hPhone

手機裝置的控制碼。

dwCallbackInstance

開啟手機裝置時所提供的應用程式回呼實例。

dwParam1

已變更的手機狀態。 此參數使用其中一個 PHONESTATE_常數

dwParam2

詳細資料狀態變更的電話狀態相關資訊。 如果在 dwParam1中設定多個旗標,因為有多個狀態專案已變更,則不會使用此參數。 應用程式應該叫用 phoneGetStatus 以取得一組完整的資訊。

如果 dwParam1 是PHONESTATE_OWNER, dwParam2 會包含新的擁有者數目。

如果 dwParam1 是PHONESTATE_MONITORS, dwParam2 會包含新的監視器數目。

如果 dwParam1 是PHONESTATE_LAMP, dwParam2 會包含已變更之燈光的按鈕/燈識別碼。

如果 dwParam1 是PHONESTATE_RINGMODE, dwParam2 會包含新的環形模式。

如果 dwParam1 是PHONESTATE_HANDSET、SPEAKER 或 HEADSET, dwParam2 就會包含該 hookswitch 裝置的新 hookswitch 模式。 此參數會使用其中一個 PHONEHOOKSWITCHMODE_常數

dwParam3

未使用的。

傳回值

沒有傳回值。

備註

您可以使用phoneSetStatusMessagesphoneGetStatusMessages來控制和查詢應用程式PHONE_STATE訊息。 根據預設,此訊息會針對所有狀態變更停用,但無法停用PHONESTATE_REINIT。 此訊息會傳送至具有電話控制碼的所有應用程式,包括呼叫 phoneOpendwPrivileges 參數設定為 PHONEPRIVILEGE_OWNER 或 PHONEPRIVILEGE_MONITOR 的應用程式。

具有擁有者和/或監視指示 的PHONE_STATE 訊息會傳送至已經擁有手機控制碼的應用程式。 這可以是另一個應用程式變更手機裝置擁有權或監視,並透過 phoneOpenphoneClosephoneShutdown的結果。

規格需求

需求
TAPI 版本
需要 TAPI 2.0 或更新版本
標頭
Tapi.h

另請參閱

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown