phoneGetDevCaps 函式 (tapi.h)

發行項
03/08/2023

phoneGetDevCaps函式會查詢指定的電話裝置，以判斷其電話語音功能。

語法

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

參數

hPhoneApp

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

dwDeviceID

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

dwAPIVersion

要使用的電話語音 API 版本號碼。高序字組包含主要版本號碼;低序字組包含次要版本號碼。此號碼是透過函式 phoneNegotiateAPIVersion取得。

dwExtVersion

要使用的服務提供者特定擴充功能版本號碼。此號碼是透過函式 phoneNegotiateExtVersion取得。如果未使用任何裝置特定的擴充功能，則可以保留零。否則，高序字會包含主要版本號碼;低序字組包含次要版本號碼。

lpPhoneCaps

PHONECAPS類型的可變大小結構的指標。成功完成要求時，此結構會填入手機裝置功能資訊。

傳回值

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

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