phoneNegotiateExtVersion 函式 (tapi.h)

phoneNegotiateExtVersion 函式可讓應用程式交涉擴充功能版本,以搭配指定的手機裝置使用。 如果應用程式不支援擴充功能,則不需要呼叫此作業。

語法

LONG phoneNegotiateExtVersion(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  DWORD     dwAPIVersion,
  DWORD     dwExtLowVersion,
  DWORD     dwExtHighVersion,
  LPDWORD   lpdwExtVersion
);

參數

hPhoneApp

使用 TAPI 處理應用程式的註冊。

dwDeviceID

要查詢之電話裝置的標識碼。

dwAPIVersion

使用 phoneNegotiateAPIVersion 交涉給指定電話裝置的 API 版本號碼。

dwExtLowVersion

phoneNegotiateAPIVersion 所傳回的最小擴充功能標識碼最新版本,應用程式符合規範。 高序字是主要版本號碼;低序字是次要版本號碼。

dwExtHighVersion

phoneNegotiateAPIVersion 所傳回的最新擴充功能標識碼延伸模組版本,該應用程式符合規範。 高序字是主要版本號碼;低序字是次要版本號碼。

lpdwExtVersion

DWORD 的指標,其中會傳回交涉的擴充功能版本號碼。 如果交涉成功,這個數位會位於 dwExtLowVersion 到 dwExtHighVersion 的範圍中。

傳回值

如果要求成功,則傳回零,如果發生錯誤,則傳回負錯誤號碼。 可能的傳回值為:

PHONEERR_INVALAPPHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_BADDEVICEID、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NODRIVER、PHONEERR_NOMEM、PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_UNINITIALIZED、PHONEERR_INVALPOINTER、PHONEERR_NODEVICE。

備註

PhoneNegotiateExtVersion 函式是用來交涉要使用的 API 版本號碼。 它會傳回電話裝置所支援的擴充功能標識符,如果沒有提供任何延伸模組,則傳回零。

為了讓應用程式使用傳回的擴充功能標識碼所定義的擴充功能,它必須呼叫 phoneNegotiateExtVersion 來交涉要使用的擴充功能版本。

使用 phoneInitializeEx 來判斷系統中存在的手機裝置數目。 dwDeviceID 指定的裝置標識碼會從零到一個小於存在的手機裝置數目。

交涉的擴充功能版本號碼是應用程式和服務提供者必須同時運作。 如果版本範圍不重疊,則應用程式和服務提供者版本不相容,並傳回錯誤。

規格需求

需求 值
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

擴充電話語音服務參考

TAPI 2.2 參考概觀

phoneInitializeEx

phoneNegotiateAPIVersion