TSPI_lineClose函式 (tspi.h)
TSPI_lineClose函式會在完成或中止裝置上所有未完成的呼叫和異步操作之後,關閉指定的開啟行裝置。
語法
LONG TSPIAPI TSPI_lineClose(
HDRVLINE hdLine
);
參數
hdLine
要關閉之行的服務提供者句柄。 成功關閉行之後,這個句柄就不再有效。
傳回值
如果函式成功,則傳回零;如果發生錯誤,則傳回錯誤號碼。 可能的傳回值如下所示:
LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL。
備註
服務提供者必須針對每個異步操作報告完成。 如果針對有未處理異步操作的行呼叫 TSPI_lineClose ,此程式傳回之前會以適當的結果或錯誤碼回報作業。
在行上作用中的呼叫有類似的需求。 未完成的作業必須以適當的結果或錯誤碼回報。 如有需要,也必須卸除作用中呼叫,而且如果此行為是由 LINEDEVCAPS 結構中的LINEDEVCAPFLAGS_CLOSEDROP位表示。
此程式傳回之後,服務提供者必須在該行上回報任何進一步 的 htCall 或呼叫。 服務提供者的行句柄,而該行上的呼叫會變成「無效」。
服務提供者必須在行開啟時放棄其保留的非可共享資源。 例如,關閉透過 comm 埠存取的線路,數據機應該會關閉 comm 連接埠,讓它再次可供其他應用程式使用。
服務提供者不會發出 LINE_LINEDEVSTATE 訊息以回應此函式調用,因為該行會關閉,而且不再對其狀態變更感興趣。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tspi.h |