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

另請參閱

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

lineInitialize

lineOpen

lineSetStatusMessages

lineShutdown

LINETRANSLATECAPS

lineUncompleteCall