TSPI_phoneNegotiateTSPIVersion函式 (tspi.h)

根據可能的 SPI 版本範圍, TSPI_phoneNegotiateTSPIVersion 函式會傳回服務提供者可為此裝置運作的最高 SPI 版本。

語法

LONG TSPIAPI TSPI_phoneNegotiateTSPIVersion(
  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 是次要版本號碼。 如果要求的範圍沒有與服務提供者支援的範圍重迭,函式會傳回PHONEERR_INCOMPATIBLEAPIVERSION。

傳回值

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

PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NODRIVER、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM PHONEERR_OPERATIONUNAVAIL。

備註

如果作業無法使用,服務提供者會傳回PHONEERR_OPERATIONUNAVAIL。 不過,如果服務提供者支援任何電話裝置,它也必須支援此函式,而且函式不得傳回PHONEERR_OPERATIONUNAVAIL。

TAPI 會在每個手機裝置的初始化順序初期呼叫此函式。

延伸模組版本的交涉是透過個別的程式 TSPI_phoneNegotiateExtVersion完成。

TAPI 層級的對應函式是多載函式,也會擷取服務提供者所支援的擴充識別碼。 在 TSPI 層級,擷取擴充識別碼是透過個別的程式來完成,也就是 TSPI_phoneGetExtensionID

規格需求

   
目標平臺 Windows
標頭 tspi.h

另請參閱

INITIALIZE_NEGOTIATION

TSPI_phoneGetExtensionID

TSPI_phoneNegotiateExtVersion