TSPI_lineSelectExtVersion函式 (tspi.h)
TSPI_lineSelectExtVersion函式會選取所指定線路裝置的指定擴充功能版本。 後續要求會根據該擴充功能版本運作。
語法
LONG TSPIAPI TSPI_lineSelectExtVersion(
HDRVLINE hdLine,
DWORD dwExtVersion
);
參數
hdLine
要選取延伸模組版本的行句柄。
dwExtVersion
要選取的擴充功能版本。 此版本號碼已使用 TSPI_lineNegotiateExtVersion 交涉。 最重要的 WORD 是主要版本號碼，而最不重要的 WORD 是次要版本號碼。 使用 零的 dwExtVersion 呼叫此函式會取消目前的選取範圍。
傳回值
如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：
LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_OPERATIONUNAVAIL。
備註
服務提供者會選取指定的擴充功能版本。 雖然指示的版本號碼可能已成功交涉，但在過渡期間可能會選取不同的擴充功能版本，在此情況下，此函式會在傳回LINEERR_INCOMPATIBLEEXTVERSION) (失敗。
選取擴充功能版本之後，該行上的後續作業會根據該擴充功能版本運作。 如果要求的範圍不包含選取的版本) ，後續會嘗試交涉擴充功能版本報告嚴格選取的版本或 0 (。 使用特殊擴充功能第0版呼叫此程式會取消目前的選取範圍。 裝置再次變成能夠支援其擴充功能版本號碼的完整範圍。
此函式在 TAPI 層級沒有直接對應，其中選取延伸模組版本會與 lineOpen 的其他功能配套。 TSPI_lineSelectExtVersion函式通常會在兩種情況下呼叫： (1) 要求開啟行的應用程式、成功的媒體類型監視變更、應用程式要求使用特定擴充功能版本，且目前未選取任何擴充功能版本。 (2) 使用特定擴充功能版本的最後一個應用程式關閉行，而且可以取消擴充功能版本選取專案。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |