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
-
未使用的。
沒有傳回值。
您可以使用phoneSetStatusMessages和phoneGetStatusMessages來控制和查詢應用程式PHONE_STATE訊息。 根據預設,此訊息會針對所有狀態變更停用,但無法停用PHONESTATE_REINIT。 此訊息會傳送至具有電話控制碼的所有應用程式,包括呼叫 phoneOpen 且 dwPrivileges 參數設定為 PHONEPRIVILEGE_OWNER 或 PHONEPRIVILEGE_MONITOR 的應用程式。
具有擁有者和/或監視指示 的PHONE_STATE 訊息會傳送至已經擁有手機控制碼的應用程式。 這可以是另一個應用程式變更手機裝置擁有權或監視,並透過 phoneOpen、 phoneClose 或 phoneShutdown的結果。
需求 | 值 |
---|---|
TAPI 版本 |
需要 TAPI 2.0 或更新版本 |
標頭 |
|