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 |