TSPI_lineGetDevCaps函式 (tspi.h)

TSPI_lineGetDevCaps函式會查詢指定的線路裝置，以判斷其電話語音功能。 傳回的信息對於線路裝置上的所有位址都是有效的。

語法

LONG TSPIAPI TSPI_lineGetDevCaps(
  DWORD         dwDeviceID,
  DWORD         dwTSPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

參數

dwDeviceID

要查詢的線路裝置。

dwTSPIVersion

交涉的 TSPI 版本號碼。 這個值已經透過 TSPI_lineNegotiateTSPIVersion 函式來交涉此裝置。

dwExtVersion

交涉的擴充功能版本號碼。 這個值已經透過 TSPI_lineNegotiateExtVersion 函式來交涉此裝置。 呼叫此函式時，TAPI 不會驗證此參數。

lpLineDevCaps

LINEDEVCAPS 類型的可變大小結構的指標。 成功完成要求時，此結構會填入線條裝置功能資訊。

傳回值

如果函式成功，則傳回零，如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NODRIVER、LINEERR_RESOURCEUNAVAIL LINEERR_NOMEM。

備註

服務提供者的行裝置標識碼編號是從傳遞至 TSPI_providerInit 函式的 dwLineDeviceIDBase 參數所設定的值順序。

dwExtVersion 正式參數會指出所要求延伸模組資訊的版本號碼。 如果為零，則不會要求任何擴充資訊。 如果是非零值，它會保留與 TSPI_lineNegotiateExtVersion 函式交涉給此裝置的值。 服務提供者會根據指定的擴充版本填入裝置和廠商特定的擴充資訊。

服務提供者會填入 LINEDEVCAPS 數據結構的所有成員，但 TAPI填入的 dwTotalSize 除外。 服務提供者不得覆寫 dwTotalSize 成員。

服務提供者必須填入 LINETERMCAPS 數據結構的所有成員，或內嵌在 LINEDEVCAPS 數據結構不同部分的結構。

在服務提供者從 TSPI_lineGetDevCaps 函式傳回之後，TAPI 會設定 LINEDEVCAPS 結構的 dwLinesStates 成員，如下所示：

LINEDEVCAPS.dwLineStates |=
    LINEDEVSTATE_OPEN |
    LINEDEVSTATE_CLOSE |
    LINEDEVSTATE_REINIT |
    LINEDEVSTATE_TRANSLATECHANGE;

規格需求

需求	值
目標平台	Windows
標頭	tspi.h

另請參閱

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit