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 |