LINE_LINEDEVSTATE訊息
TAPI LINE_LINEDEVSTATE 訊息會線上路裝置的狀態變更時傳送。 應用程式可以叫用 lineGetLineDevStatus 來判斷該行的新狀態。
參數
-
hDevice
-
線條裝置的控制碼。 當 dwParam1 LINEDEVSTATE_REINIT時,此參數為Null。
-
dwCallbackInstance
-
開啟行時提供的回呼實例。 如果 dwParam1 參數是LINEDEVSTATE_REINIT, dwCallbackInstance 參數無效且設定為零。
-
dwParam1
-
已變更的行裝置狀態專案。 參數可以是一或多個 LINEDEVSTATE_常數。
-
dwParam2
-
此參數的解譯取決於 dwParam1的值。 如果 dwParam1 是LINEDEVSTATE_RINGING, dwParam2 會包含通道模式,參數會指示線路為環形。 有效的環形模式是 dwNumRingModes範圍中的數位,其中 dwNumRingModes 是線條裝置功能。
如果 dwParam1 是LINEDEVSTATE_REINIT,而且 TAPI 會發出訊息,因為將新的 API 訊息轉譯成 REINIT 訊息,則 dwParam2 會包含原始訊息 (的 dwMsg 參數,例如 ,LINE_CREATE 或LINE_LINEDEVSTATE) 。 如果 dwParam2 為零,這表示 REINIT 訊息是「實際」REINIT 訊息,要求應用程式在最早的便利性呼叫 lineShutdown 。
-
dwParam3
-
此參數的解譯取決於 dwParam1的值。 如果 dwParam1 是LINEDEVSTATE_RINGING, dwParam3 就會包含此環形事件的通道計數。 環形計數從零開始。
如果dwParam1是LINEDEVSTATE_REINIT,而且 TAPI 會發出訊息,因為將新的 API 訊息轉譯成 REINIT 訊息,則dwParam3會包含原始訊息 (的 dwParam1 參數,例如,LINEDEVSTATE_TRANSLATECHANGE或其他一些LINEDEVSTATE_值,如果dwParam2是LINE_LINEDEVSTATE或新的裝置識別碼,則 如果dwParam2LINE_CREATE) 。
傳回值
沒有傳回值。
備註
您可以使用lineSetStatusMessages來控制傳送LINE_LINEDEVSTATE訊息。 應用程式可以指出其想要通知的狀態專案變更。 根據預設,除了無法停用的LINEDEVSTATE_REINIT之外,所有狀態報表都會停用。 此訊息會傳送至具有行控制碼的所有應用程式,包括呼叫 lineOpen 且 dwPrivileges 參數設定為 LINECALLPRIVILEGE_NONE、LINECALLPRIVILEGE_OWNER、LINECALLPRIVILEGE_MONITOR或允許組合的應用程式。
規格需求
需求 | 值 |
---|---|
TAPI 版本 |
需要 TAPI 2.0 或更新版本 |
標頭 |
|