TSPI_phoneNegotiateExtVersion函式 (tspi.h)

  • 發行項

TSPI_phoneNegotiateExtVersion函式會根據可能的擴充功能版本範圍，傳回服務提供者可為此裝置操作的最高擴充版本號碼。

語法

LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

參數

dwDeviceID

識別要執行介面版本交涉的電話裝置。

dwTSPIVersion

指定使用此裝置使用 TSPI_phoneNegotiateTSPIVersion交涉的介面版本號碼。 此函式會根據這個版本層級的介面規格運作。

dwLowVersion

TAPI 或其用戶端應用程式可以運作的最低擴充功能版本號碼。 最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。

dwHighVersion

TAPI 或其用戶端應用程式可以運作的最高擴充功能版本號碼。 最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。

lpdwExtVersion

DWORD的指標。 從此函式成功傳回時，服務提供者會在呼叫者要求的範圍內，填入此位置的最高延伸模組版本號碼，而服務提供者可以在該範圍內運作。 最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。 如果要求的範圍未與服務提供者支援的範圍重迭，函式會傳回PHONEERR_INCOMPATIBLEEXTVERSION。

傳回值

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

PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_OPERATIONFAILED、PHONEERR_NODRIVER、PHONEERR_OPERATIONUNAVAIL PHONEERR_NOMEM。

備註

此函式可以在 TAPI 開啟裝置之前或之後呼叫。 如果裝置目前已開啟且已選取擴充功能版本，則函式應該會在要求的範圍內傳回該版本號碼。 如果選取的版本號碼超出要求的範圍，函式會傳回PHONEERR_INCOMPATIBLEEXTVERSION。

需求

   
目標平台 Windows
標頭 tspi.h

另請參閱

TSPI_phoneNegotiateTSPIVersion