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

另請參閱

INITIALIZE_NEGOTIATION

TSPI 版本控制

TSPI_lineGetExtensionID

TSPI_lineNegotiateExtVersion

TSPI_providerInit