TSPI_lineNegotiateTSPIVersion函式 (tspi.h)
TSPI_lineNegotiateTSPIVersion函式會傳回服務提供者可針對此裝置運作的最高 SPI 版本,因為有可能的 SPI 版本範圍。
語法
LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
參數
dwDeviceID
識別要執行介面版本交涉的行裝置。 除了服務提供者所支援範圍內的裝置標識碼之外,這可能是值:
INITIALIZE_NEGOTIATION
這個值用來表示要交涉整體介面版本。
dwLowVersion
TAPI 可以運作的最低 TSPI 版本號碼。 最重要的 WORD 是主要版本號碼,而最小有效 WORD 是次要版本號碼。
dwHighVersion
TAPI 可以運作的最高 TSPI 版本號碼。 最重要的 WORD 是主要版本號碼,而最小有效 WORD 是次要版本號碼。
lpdwTSPIVersion
DWORD 的指標。 服務提供者會在呼叫者要求的範圍內,以最高的 TSPI 版本號碼填入此位置,而服務提供者可以在該範圍內運作。 最重要的 WORD 是主要版本號碼,而最小有效 WORD 是次要版本號碼。 如果要求的範圍與服務提供者支援的範圍不重疊,函式會傳回LINEERR_INCOMPATIBLEAPIVERSION。
傳回值
如果函式成功,則傳回零,如果發生錯誤,則傳回錯誤號碼。 可能的傳回值如下所示:
LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_NODRIVER、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。
備註
當 dwDeviceIDINITIALIZE_NEGOTIATION時,此函式不得傳回LINEERR_OPERATIONUNAVAIL,因為即使服務提供者不支援任何線路裝置,此函式 (與該值) 是交涉整體介面版本的必要專案。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tspi.h |