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 或更新版本
標頭	Tapi.h

另請參閱

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown