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) 使用特定擴充功能版本的最後一個應用程式關閉行，而且可以取消擴充功能版本選取專案。

規格需求

另請參閱

TSPI_lineNegotiateExtVersion