LINE_REMOVE訊息
TAPI LINE_REMOVE 訊息會傳送,以通知應用程式從系統) 裝置移除 (刪除。 一般而言,這不會用於暫時移除,例如擷取 PCMCIA 裝置,但僅限於服務提供者在重新初始化 TAPI 時不會再回報裝置的永久移除。
參數
-
hDevice
-
保留的。 設定為零。
-
dwCallbackInstance
-
保留的。 設定為零。
-
dwParam1
-
已移除之線條裝置的識別碼。
-
dwParam2
-
保留的。 設定為零。
-
dwParam3
-
保留的。 設定為零。
傳回值
沒有傳回值。
備註
支援 TAPI 2.0 版或更新版本的應用程式會傳送 LINE_REMOVE 訊息。 這會通知他們裝置已從系統中移除。 如果應用程式開啟行, 則LINE_REMOVE 訊息前面會有每個行控制碼上的 LINE_CLOSE 訊息。 此訊息會傳送至所有支援 TAPI 2.0 版或更新版本且已呼叫 lineInitializeEx的應用程式,包括目前未開啟任何行裝置的應用程式。
繼承應用程式會傳送 LINE_LINEDEVSTATE 訊息,指定LINEDEVSTATE_REMOVED,後面接著LINE_CLOSE訊息。 不過,不同于 LINE_REMOVE 訊息,這些較舊的應用程式只有在移除行時才會收到這些訊息。 如果他們未開啟行,則只會指出裝置在嘗試存取裝置時收到LINEERR_NODEVICE錯誤。
移除裝置之後,任何依裝置識別碼存取裝置的嘗試都會導致LINEERR_NODEVICE錯誤。 當所有 TAPI 應用程式都關閉之後,TAPI 就可以重新開機,而且當 TAPI 重新初始化時,已移除的裝置不再佔用裝置識別碼。
注意
實作:這是會傳回此LINEERR_NODEVICE的 TAPI;從服務提供者收到 LINE_REMOVE 訊息之後;沒有使用該行裝置識別碼對該服務提供者進行進一步的呼叫。
規格需求
需求 | 值 |
---|---|
TAPI 版本 |
需要 TAPI 2.0 或更新版本 |
標頭 |
|